MkParseDisplayNameEx (Windows Embedded CE 6.0)

1/6/2010

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

Syntax

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 Value

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

Header urlmon.h, urlmon.idl
Library urlmon.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

URL Moniker Services Functions