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.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in urlmon.h.