IBindStatusCallback::OnStopBinding

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method 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. If there is error, this text describes the error. In the current implementation of URL monikers, this string is empty.

Return Value

Returns S_OK if this is 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 finished, the moniker client must call 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

See Also

Reference

URL Moniker Services Interfaces