CreateURLMonikerEx2 function

Creates a new URL moniker from a full Uniform Resource Identifier (URI), or from a base context URL moniker and a relative URI.

Syntax

HRESULT CreateURLMonikerEx2(
   IMoniker *pMkCtx,
   IUri     *pUri,
   IMoniker **ppmk,
   DWORD    dwFlags
);

pMkCtx

A pointer to an IMoniker interface of the URL moniker to use as the base context. The pMkCtx parameter can be NULL.

pUri

A pointer to an IUri interface that contains a full or relative URI.

ppmk

A pointer to an IMoniker interface for the new URL moniker.

dwFlags

An unsigned long integer value that contains a combination of the following flags.

URL_MK_LEGACY (0)

Create legacy file URLs. Equivalent to Uri_CREATE_FILE_USE_DOS_PATH.

URL_MK_UNIFORM (1)

Use the updated URL parser.

URL_MK_NO_CANONICALIZE (2)

Do not attempt to convert the URL moniker to the standard format.

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Any two URIs can be combined. The base URI and context URI can be any combination of relative and absolute. This is also true for the CoInternetCombineUrl function, the CoInternetCombineUrlEx function, and the CoInternetCombineIUri function.