MkParseDisplayNameEx
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 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
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 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 parameter 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.
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 |