IBindStatusCallback::OnStopBinding method

Indicates the end of the bind operation.

Syntax

HRESULT OnStopBinding(
  [in] HRESULT hresult,
  [in] LPCWSTR szError
);

Parameters

hresult [in]

The status code returned from the bind operation.

szError [in]

The address of a string value that contains the status text. In case of error, this text describes the error. In the current implementation of URL monikers, this string is empty.

Return value

Returns S_OK if successful, or an error value otherwise.

Remarks

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

Because URL monikers work asynchronously, the status code returned by IBindStatusCallback::OnStopBinding and the status code returned by the binding methods, such as IMoniker::BindToStorage and IMoniker::BindToObject, might differ.

Client applications that implement the IBindStatusCallback interface can return E_UNIMPL or S_OK, if they don't want to receive this notification.

Requirements

See also

IBindStatusCallback