IParseDisplayName::ParseDisplayName

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 lefthand side of the string.

HRESULT ParseDisplayName(

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

Parameters

pbc

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

pszDisplayName

[in] Points 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] Receives the number of characters in the display name that correspond to the ppmkOut moniker.

ppmkOut

[out] Receives a 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::AddRef; so it is the caller's responsibility to call (*ppmkOut)->IUnknown::Release.

Return Values

S_OK

Indicates success.

MK_E_SYNTAX

Indicates a syntax error in the display name.

MK_E_NOOBJECT

Indicates that the display name does not identify a component in this namespace.

E_UNEXPECTED

Indicates an unexpected error.

E_OUTOFMEMORY

Indicates insufficient memory.

See Also

MkParseDisplayName, IMoniker::ParseDisplayName

Software for developers

Delphi Components
.Net Components
Software for Android Developers

More information resources

MegaDetailed.Net
Unix Manual Pages
Delphi Examples