IBindStatusCallback::OnStopBindingIBindStatusCallback::OnStopBinding*
*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

Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.