IParseDisplayName::ParseDisplayName - OLE Programmer's Reference (ole.hlp)

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

More Online Helps

Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages

greatis just4fun network