IBindHost::MonikerBindToStorage Method

---

Binds a moniker to storage.

Syntax

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

Parameters

pMk

[in] Address of the IMoniker interface.

pBC

[in] Address of the IBindCtx interface.

pBSC

[in] Address of the IBindStatusCallback interface.

riid

[in] Identifier of the storage interface requested.

ppvObj

[out] Address of the storage interface. If ppvObj is non-NULL, the application must call the IUnknown::AddRef method on the interface and call IUnknown::Release when it is finished using the interface.

Return Value

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. The behavior matches that of IMoniker::BindToStorage.
E_OUTOFMEMORY	There is insufficient memory to create the moniker.
E_UNEXPECTED	An unknown error occurred.

Remarks

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.

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0