IBindHost::MonikerBindToObjectIBindHost::MonikerBindToObject*
*Contents  *Index  *Topic Contents

*Previous Topic: IBindHost::CreateMoniker
*Next Topic: IBindHost::MonikerBindToStorage

IBindHost::MonikerBindToObject

HRESULT MonikerBindToObject(
    IMoniker *pMk,
    IBindCtx *pBC, 
    IBindStatusCallback *pBSC, 
    REFIID riid, 
    void **ppvObj);

Should be the single mechanism controls use when trying to bind to the object addressed by a moniker.

pMk
[in] Moniker to bind to.
pBC
[in] Optional bind context to be used when binding the moniker. This parameter can be used by the control for passing in additional bind options, such as a format enumerator (IEnumFormatETC).
pBSC
[in] Callback interface whereby the control receives asynchronous callbacks pertaining to the bind operation. The control must provide its callback interface separately, not registered on the pBC parameter.
riid
[in] Identifier of the desired storage interface. Serves the same purpose as the analogous parameter in IMoniker::BindToObject.
ppvObj
[out] Result of the bind operation (if it is synchronous). This parameter serves the same purpose as the analogous parameter in IMoniker::BindToObject.

This method behaves exactly the same as IMoniker::BindToObject, except that it provides the control container (implementor of IBindHost) enough authority over the bind operation so that the control container can take charge of setting bind options and priority, while delegating all results and callbacks for the bind operation back to the control.

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