IUniformResourceLocator::SetURL Method

---

Sets an object's URL.

Syntax

HRESULT SetURL(
    LPCSTR pcszURL,
    DWORD dwInFlags
);

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.

Return Value

Returns one of the following values:

S_OK	The object's URL was set successfully.
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.