MkParseDisplayNameEx function
Creates a moniker to the object that is specified by the given string.
Syntax
HRESULT MkParseDisplayNameEx(
_In_ IBindCtx *pbc,
_In_ LPWSTR szDisplayName,
_Out_ unsigned long *pcchEaten,
_Out_ IMoniker **ppmk
);
Parameters
pbc [in]
The address of the IBindCtx interface of the bind context in which to accumulate bound objects.szDisplayName [in]
The address of the string value to parse.pcchEaten [out]
The address of an unsigned long integer value that indicates the number of characters successfully parsed.ppmk [out]
A pointer to the IMoniker interface of the resulting moniker.
Return value
Returns one of the following values.
| Return code | Description |
|---|---|
| S_OK | Successful. |
| E_OUTOFMEMORY | There is 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 can only be partially resolved into a moniker. In this case, pcchEaten receives the number of characters that are 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 returns a valid moniker.
Security Warning: Calling MkParseDisplayName or MkParseDisplayNameEx with a szDisplayName parameter from a non-trusted source is unsafe. Not only can an arbitrary class be instantiated but some moniker implementations might act on the string during parsing instead of deferring this to binding.
Requirements
Minimum supported client |
Windows XP |
Minimum supported server |
Windows 2000 Server |
Product |
Internet Explorer 3.0 |
Header |
Urlmon.h |
Library |
Urlmon.lib |
DLL |
Urlmon.dll |