Contents Index Topic Contents | ||
Previous Topic: IBindStatusCallback::OnStartBinding Next Topic: IHttpNegotiate::BeginningTransaction |
IBindStatusCallback::OnStopBinding
HRESULT OnStopBinding( [in] HRESULT hrStatus, [in] LPCWSTR szStatusText );Indicates the end of the bind operation.
- hrStatus
- Status code returned from the bind operation.
- szStatusText
- Status text. In case of error, this text describes the error. In the current implementation of URL monikers, this string is empty.
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 completed, the moniker client must call IUnknown::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) may differ.
Notes to implementers
A client can return E_UNIMPL or S_OK if it is not interested in receiving this notification.
See also IBinding, IBindStatusCallback::OnStartBinding
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.