CreateURLMoniker function

Deprecated in Windows Internet Explorer 7. Use CreateURLMonikerEx instead.

Syntax


HRESULT CreateURLMoniker(
  _In_  IMoniker *pMkCtx,
  _In_  LPCWSTR  szURL,
  _Out_ IMoniker **ppmk
);

Parameters

pMkCtx [in]: The 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 pMkCtx parameter can be NULL.
szURL [in]: The address of a string value that contains the display name to be parsed.
ppmk [out]: Pointer to an IMoniker interface for the new URL moniker.

Return value

Returns one of the following values.

Return code	Description
S_OK	Success.
E_OUTOFMEMORY	The operation ran out of memory.
MK_E_SYNTAX	A moniker cannot 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 the syntax for URLs is extremely flexible.

Remarks

The CreateURLMoniker function creates a URL moniker from a full URL string, or from a base context URL moniker and a partial URL string.

Security Warning: This function does not correctly interpret percent encoded octets in Windows file paths or "file://" scheme Uniform Resource Identifiers (URIs). On systems with Microsoft Internet Explorer 6 and earlier, calling CreateURLMoniker with the output of a previous call might produce a result that is not equivalent. Since CreateURLMoniker can produce results that are not equivalent to the input, its use can result in security problems.

Use CreateURLMonikerEx with the URL_MK_UNIFORM flag to ensure that Windows file paths and "file://" URIs are interpreted correctly with regard to percent encoded octets; and that the result is equivalent to the input. To correctly extract a Windows file path from the result of CreateURLMoniker, use the PathCreateFromUrl function.

Requirements

Minimum supported client	Windows XP
Minimum supported server	Windows 2000 Server
Product	Internet Explorer 3.0
Header	Urlmon.h
Library	Urlmon.lib
DLL	Urlmon.dll