CreateURLMoniker Function

---

Creates a URL moniker from either a full URL string or from a base context URL moniker and a partial URL string.

Syntax

HRESULT CreateURLMoniker(
    IMoniker *pmkContext,
    LPWSTR szURL,
    IMoniker **ppmk
);

Parameters

pmkContext

[in] Address of the IMoniker interface for the URL moniker to use as the base context when the szURL parameter is a partial URL string. The pmkContext parameter can be NULL.

szURL

[in] Address of a string value that contains the display name to be parsed.

ppmk

[out] Address of a pointer to an IMoniker interface for the new URL moniker.

Return Value

Returns one of the following values:

S_OK	Success.
E_OUTOFMEMORY	The operation ran out of memory.
MK_E_SYNTAX	A moniker could not be created because szURL does not correspond to valid URL syntax for a full or partial URL. This is uncommon, because most parsing of the URL occurs during binding and because the syntax for URLs is extremely flexible.

Function Information

Windows NT	Use version 4.0. Implemented as a Unicode function.
Windows	Use Windows 95 and later. Implemented as a Unicode function.
Header	Urlmon.h
Import Library	Urlmon.lib
Minimum availability	Internet Explorer 3.0

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0