IBindHost::CreateMonikerIBindHost::CreateMoniker*
*Contents  *Index  *Topic Contents
*Previous Topic: IBindHost
*Next Topic: IBindHost::MonikerBindToObject

IBindHost::CreateMoniker

HRESULT CreateMoniker(
    LPCOLESTR pszName,
    IBindCtx *pBC,
    IMoniker **ppmk, 
    DWORD dwReserved);

Provides the caller with a means to turn some sort of text name into a moniker so that the caller does not have to interpret the name in any way itself. In many cases, the implementation of CreateMoniker will simply call MkParseDisplayNameEx, but this method gives the implementor of IBindHost a chance to catch host-specific strings that MkParseDisplayNameEx would not otherwise recognize.

pszName
[in] Address of the string containing the name to parse.
pBC
[in] Optional bind context to be used when creating the moniker. This parameter is currently ignored, but may be used in the future for passing additional information.
ppmk
[out] Address of the caller's IMoniker * variable in which to store the moniker created from pszName. The caller is responsible for calling IMoniker::Release when the moniker is no longer needed.
dwReserved
[in] Reserved for future use, must be zero.

E_NOTIMPL is disallowed—a bind host is responsible for providing moniker parsing services.


Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.