IBindStatusCallback::OnStopBinding
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::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 |
| Windows Mobile | Windows Mobile Version 5.0 and later |