Share via

MkParseDisplayNameEx

  • Article

This function creates a moniker to the object that is specified by the given string.

HRESULT MkParseDisplayNameEx(
  IBindCtx* pbc,
  LPWSTR szDisplayName,
  ULONG* pcchEaten,
  IMoniker** ppmk
);

Parameters

  • pbc
    [in] Address of the IBindCtx interface of the bind context in which to accumulate bound objects.
  • szDisplayName
    [in] Address of the string value to be parsed.
  • pcchEaten
    [out] Address of an unsigned long integer value that indicates the number of characters successfully parsed.
  • ppmk
    [out] Address of a pointer to the IMoniker interface of the resulting moniker.

Return Values

This function returns one of the values shown in the following table.

Value Description
S_OK Success.
E_OUTOFMEMORY There was 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 could only be partially resolved into a moniker. In this case, pcchEaten receives the number of characters that were successfully parsed into a moniker prefix.
NOERROR The szDisplayName parameter 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 should return a valid moniker.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Urlmon.h, Urlmon.idl.
Link Library: Urlmon.lib.

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.