IUniformResourceLocator::SetURL Method

Sets an object's URL.

Syntax

HRESULT SetURL(
    LPCSTR pcszURL,
    DWORD dwInFlags
);

Return Value

Returns one of the following values:

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.

Parameters

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.

Does this content meet your programming needs? Write us!

Back to top