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
);

Parameters

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.

Return value

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

Remarks

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.

Requirements

Minimum supported client

Windows XP with SP2

Minimum supported server

Windows Server 2003 with SP1

Product

Internet Explorer 7

Header

Urlmon.h

Library

Urlmon.lib

DLL

Urlmon.dll

See also

Reference

CreateURLMonikerEx

CreateUri