IBindStatusCallback::OnStopBinding

Indicates the end of the bind operation.

Syntax

HRESULT OnStopBinding(
  HRESULT hresult,
  LPCWSTR szError
);

Parameters

hresult
[in] Status code returned from the bind operation.
szError
[in] 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 Values

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. At this point 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 IUnknown::Release on the IBinding pointer 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 are not interested in receiving this notification.

Requirements

Pocket PC: Pocket PC 2000 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: urlmon.h
Library: urlmon.lib

Share via