MkParseDisplayNameEx 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 IBindCtx interface 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 IMoniker interface of the resulting moniker.

Return Value

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, pcchEaten 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 pcchEaten contains a nonzero value, a subsequent call to MkParseDisplayNameEx with the same pbc parameter and a shortened szDisplayName parameter should return a valid moniker.

Function Information

Windows NT	Use version 4.0. Implemented as a Unicode function.
Windows	Use Windows 95 and later. Implemented as a Unicode function.
Header	Urlmon.h
Import Library	Urlmon.lib
Minimum availability	Internet Explorer 3.0

See Also

IParseDisplayName