Contents Previous Page Next Page
IBindStatusCallback::OnStopBinding

An asynchronous moniker calls this method to indicate the end of the bind operation.

HRESULT OnStopBinding(

    HRESULT  
hrStatus,             //Bind operation status code       
                                                                      
    LPCWSTR  szStatusText          //Status text                      
                                                                      
   );                                                                 
                                                                      

Parameters

hrStatus

[in] Status code which would have been returned from the method that initiated the bind operation: either IMoniker::BindToObject or IMoniker::BindToStorage.

szStatusText

[in] Status text. In case of error, this text describes the error. In case of success, the text displays the friendly name of the bound data location. In the current implementation of URL monikers, this string is empty.

Return Values

S_OK

The operation was successful.

Remarks

This method is always called, whether the bind operation succeeded, failed, or was aborted by a client. At this point the moniker client can use IBinding::GetBindResult to query for protocol-specific information about the outcome of the bind operation. Once this method has completed, the moniker client must call Release on the IBinding pointer it received in IBindStatusCallback::OnStartBinding.

Notes to Implementers

A client can return E_UNIMPL or S_OK if it is not interested in receiving this notification.

See Also

IBinding, IBindStatusCallback::OnStartBinding