Share via


IBindStatusCallback::OnStopBinding (Windows Embedded CE 6.0)

1/6/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

Header urlmon.h, urlmon.idl
Library urlmon.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

IBindStatusCallback
URL Moniker Services Interfaces