Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function creates a moniker to the object that is specified by the given string.

Syntax 

HRESULT MkParseDisplayNameEx(
  IBindCtx* 
pbc,
  LPWSTR 
szDisplayName,
  ULONG* 
pcchEaten,
  IMoniker** 
ppmk
);

Parameters

pbc

[in] Address of the IBindCtxinterface of the bind context in which to accumulate bound objects.

szDisplayName

[in] Address of the string value to be parsed.

pcchEaten

[out] Address of an unsigned long integer value that indicates the number of characters successfully parsed.

ppmk

[out] Address of a pointer to the IMonikerinterface of the resulting moniker.

Return Value

This function returns one of the values shown in the following table.

Value Description

S_OK

Success.

E_OUTOFMEMORY

There was insufficient memory to complete the operation.

INET_E_UNKNOWN_PROTOCOL

The szDisplayNameparameter contains a protocol, other than telnet, that does not have a valid protocol handler assigned.

MK_E_SYNTAX

Parsing failed because szDisplayNamecould only be partially resolved into a moniker. In this case, pcchEatenreceives the number of characters that were successfully parsed into a moniker prefix.

NOERROR

The szDisplayNameparameter uses a telnet protocol, for which the function does not have a valid protocol handler.

Remarks

When MK_E_SYNTAX is returned and pcchEatencontains a nonzero value, a subsequent call to MkParseDisplayNameExwith the same pbcparameter and a shortened szDisplayNameparameter should return a valid moniker.

Requirements

Header urlmon.h, urlmon.idl
Library urlmon.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later