Contents Index Topic Contents | ||
Previous Topic: IBindHost::MonikerBindToObject Next Topic: IServiceProvider |
IBindHost::MonikerBindToStorage
HRESULT MonikerBindToStorage( IMoniker *pMk, IBindCtx *pBC, IBindStatusCallback *pBSC, REFIID riid, void **ppvObj);Should be the single mechanism controls use when trying to bind to the data addressed by a moniker.
- Returns one of the following values:
S_OK The bind operation completed synchronously and successfully. The result of the bind operation is available in ppvObj. MK_S_ASYNCHRONOUS The bind operation will complete asynchronously. Behavior matches that of IMoniker::BindToStorage. E_OUTOFMEMORY There is insufficient memory to create the moniker. E_UNEXPECTED An unknown error occurred.
- 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::BindToStorage.
- ppvObj
- [out] Result of the bind operation (if it is synchronous). This parameter serves the same purpose as the analogous parameter in IMoniker::BindToStorage.
This method behaves exactly the same as IMoniker::BindToStorage, 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.
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.