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 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