IBindStatusCallback::OnStopBinding method
Indicates the end of the bind operation.
Syntax
HRESULT OnStopBinding(
[in] HRESULT hresult,
[in] LPCWSTR szError
);
Parameters
hresult [in]
The status code returned from the bind operation.szError [in]
The 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 value
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. 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 Release on the IBinding pointer that 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 don't want to receive this notification.
Requirements
Minimum supported client |
Windows XP |
Minimum supported server |
Windows Server 2003 |
Product |
Internet Explorer 4.0 |
DLL |
Urlmon.dll |