MkParseDisplayNameEx


		Contents Index Topic Contents
	Previous Topic: IsValidURL Next Topic: ObtainUserAgentString

MkParseDisplayNameEx
HRESULT MkParseDisplayNameEx(
    [in] IBindCtx*pbc,
    [in] LPWSTR  szDisplayName,
    [out] ULONG *pcchEaten,
    [out] IMoniker **ppmk
);
Given a string, returns a moniker of the object that the string denotes.
Returns one of the following values:

S_OK Success.

E_OUTOFMEMORY The operation ran out of memory.

MK_E_SYNTAX Parsing failed because szDisplayName could only be partially resolved into a moniker. In this case, pcchEaten has the number of characters that were successfully parsed into a moniker prefix.

pbc
Address of the bind context in which to accumulate bound objects.
szDisplayName
Display name to be parsed.
pcchEaten
Address of the number of characters of the display name that were successfully parsed. Most useful on syntax error, when a nonzero value is often returned and therefore a subsequent call to MkParseDisplayNameEx with the same pbc parameter and a shortened szDisplayName parameter should return a valid moniker.
ppmk
Indirect pointer to the resulting moniker.

See also IParseDisplayName

Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.

S_OK	Success.
E_OUTOFMEMORY	The operation ran out of memory.
MK_E_SYNTAX	Parsing failed because szDisplayName could only be partially resolved into a moniker. In this case, pcchEaten has the number of characters that were successfully parsed into a moniker prefix.