MkParseDisplayNameEx

Article
08/28/2006

Creates a moniker to the object that is specified by the given string.

Syntax

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

Parameters

pbc
[in] Address of the IBindCtx interface of the bind context in which to accumulate bound objects.
szDisplayName
[in] Address of the string value to be parsed.
pchEaten
[out] Address of an unsigned long integer value that indicates the number of characters successfully parsed.
ppmk
[out] Address of a pointer to the IMoniker interface of the resulting moniker.

Return Values

Returns one of the following values:

S_OK
Success.
E_OUTOFMEMORY
There was insufficient memory to complete the operation.
INET_E_UNKNOWN_PROTOCOL
The szDisplayName parameter contains a protocol (other than telnet) that does not have a valid protocol handler assigned.
MK_E_SYNTAX
Parsing failed because szDisplayName could only be partially resolved into a moniker. In this case, pchEaten receives the number of characters that were successfully parsed into a moniker prefix.
NOERROR
The szDisplayName uses a telnet protocol, for which the function does not have a valid protocol handler.

Remarks

When MK_E_SYNTAX is returned and pchEaten contains a nonzero value, a subsequent call to MkParseDisplayNameEx with the same pbc parameter and a shortened szDisplayName parameter should return a valid moniker.

Requirements

Pocket PC: Pocket PC 2000 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: urlmon.h
Library: urlmon.lib

Share via