Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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::GetBindResultto query for protocol-specific information about the outcome of the bind operation. When this method has finished, the moniker client must call Releaseon the IBindingpointer it received in IBindStatusCallback::OnStartBinding.

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

Client applications that implement the IBindStatusCallbackinterface 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
Windows Mobile Windows Mobile Version 5.0 and later

See Also