IParseDisplayName::ParseDisplayName HNWIS2

Parses the display name to extract a component of the string that it can convert into a moniker, using the maximum number of characters from the left side of the string.

HRESULT ParseDisplayName(

IBindCtx *pbc,	//Pointer to bind context
LPOLESTR pszDisplayName,	//Pointer to string containing display name
ULONG *pchEaten,	//Pointer to length, in characters, of display name
IMoniker **ppmkOut	//Indirect pointer to moniker that results
);

Parameters

pbc

[in] Pointer to the bind context to be used in this binding operation.

pszDisplayName

[in] Pointer to a zero-terminated string containing the display name to be parsed. For Win32 applications, the LPOLESTR type indicates a wide character string (two bytes per character); otherwise, the string has one byte per character.

pchEaten

[out Pointer to the number of characters in the display name that correspond to the ppmkOut moniker.

ppmkOut

[out] Indirect pointer to the resulting moniker. If an error occurs, the implementation sets *ppmkOut to NULL. If *ppmkOut is non-NULL, the implementation must call (*ppmkOut)->IUnknown::AddRef1SHW0SS; so it is the caller s responsibility to call (*ppmkOut)->IUnknown::ReleaseDUW01A.

Return Values

This method supports the standard return values E_OUTOFMEMORY and E_UNEXPECTED, as well as the following:

S_OK

Success.

MK_E_SYNTAX

Syntax error in the display name.

MK_E_NOOBJECT

The display name does not identify a component in this namespace.