IBindStatusCallback::OnStartBinding


		Contents Index Topic Contents
	Previous Topic: IBindStatusCallback::OnProgress Next Topic: IBindStatusCallback::OnStopBinding

IBindStatusCallback::OnStartBinding
HRESULT OnStartBinding(
    [in] DWORD  dwReserved,
    [in] IBinding *pbinding
);
Notifies the client about the callback methods it is registered to receive. This notification is a response to the flags the client requested in the RegisterBindStatusCallback function.
Returns S_OK if successful, or E_INVALIDARG if the pbinding parameter is invalid.

dwReserved
Reserved for future use. Must be zero.
pbinding
Address of the IBinding interface of the current bind operation. Cannot be NULL. The client should call AddRef on this pointer to keep a reference to the binding object.

Asynchronous monikers typically call this method before the call to the IMoniker::BindToStorage or IMoniker::BindToObject method has returned.
In the call to this method, the moniker also provides the client with a pointer to the IBinding interface for the binding object associated with the current bind operation. The client can use the IBinding interface to control the progress of the bind operation.
To keep a reference to the binding object, the client must store the pointer to the IBinding interface and call AddRef on it. When the client no longer needs the reference, it must call Release on it. Note that calling Release does not cancel the bind operation; it simply frees the reference to the IBinding interface sent in the callback.
Notes to implementers
A client can return E_NOTIMPL or S_OK if it is not interested in receiving this notification.
The IBinding::Abort method will not work properly within an implementation of IBindStatusCallback::OnStartBinding. To abort the binding, IBindStatusCallback::OnStartBinding should return E_FAIL.
See also IBinding, IBindStatusCallback::OnStopBinding, RegisterBindStatusCallback

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