IBindHost::GetBindCtx is the factory method for a host-initialized bind context. It supplies a pointer to an implementation of IBindCtx. Its arguments are identical to those for the API function CreateBindCtx.

HRESULT GetBindCtx(

    DWORD 

dwReserved,          //Reserved for future use; must be zero           
                                                                                 

    IBindCtx ** ppbc           //Indirect pointer to the IBindCtx interface      
                                                                                 

   );                                                                            
                                                                                 

dwReserved

[in] Reserved for future use; must be zero.

ppbc

[out] Indirect pointer the IBindCtx pointer. The caller is responsible for calling IBindCtx::Release when the bind context is no longer needed.

Return Values

S_OK

The bind context was successfully obtained and the caller is responsible for the interface pointer.

E_OUTOFMEMORY

There is insufficient memory to create the bind context.

E_UNEXPECTED

An unknown error occurred.

Remarks

E_NOTIMPL is not allowed a bind host is responsible for providing bind context creation services.