IUniformResourceLocator::SetURL


		Contents Index Topic Contents
	Previous Topic: IUniformResourceLocator::InvokeCommand Next Topic: Internet Shortcut Global Functions

IUniformResourceLocator::SetURL
HRESULT SetURL(
    LPCSTR pcszURL,
    DWORD dwInFlags
);
Sets an object's URL.
Returns S_OK if the object's URL was set successfully. Otherwise, the return value is an error code that can be one of the following:

E_OUTOFMEMORY There is not enough memory to complete the operation.

IS_E_EXEC_FAILED The URL's protocol handler failed to run.

URL_E_INVALID_SYNTAX The URL's syntax is invalid.

URL_E_UNREGISTERED_PROTOCOL The URL's protocol does not have a registered protocol handler.

pcszURL
Address of a zero-terminated string that contains the URL to set. The protocol scheme may be included as part of the URL.
dwInFlags
Flag value that specifies the behavior for setting the protocol scheme. This field can contain one of the following values:

IURL_SETURL_FL_GUESS_PROTOCOL If the protocol scheme is not specified in pcszURL, the system automatically chooses a scheme and adds it to the URL.

IURL_SETURL_FL_USE_DEFAULT_PROTOCOL If the protocol scheme is not specified in pcszURL, the system adds the default protocol scheme to the URL.

Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.

E_OUTOFMEMORY	There is not enough memory to complete the operation.
IS_E_EXEC_FAILED	The URL's protocol handler failed to run.
URL_E_INVALID_SYNTAX	The URL's syntax is invalid.
URL_E_UNREGISTERED_PROTOCOL	The URL's protocol does not have a registered protocol handler.

IURL_SETURL_FL_GUESS_PROTOCOL	If the protocol scheme is not specified in pcszURL, the system automatically chooses a scheme and adds it to the URL.
IURL_SETURL_FL_USE_DEFAULT_PROTOCOL	If the protocol scheme is not specified in pcszURL, the system adds the default protocol scheme to the URL.