RegisterBindStatusCallback

Article
08/28/2006

Registers a callback interface with an existing bind context.

Syntax

HRESULT RegisterBindStatusCallback(
  LPBC * pBC,
  IBindStatusCallback * pBSCb,
  IBindStatusCallback * * ppBSCBPrev,
  DWORD dwReserved
);

Parameters

pBC
[in] Address of the IBindCtx interface from which to receive callbacks.
pBSCb
[in] Address of the IBindStatusCallback interface implementation to be registered.
ppBSCBPrev
[out] Address of a pointer to a previously registered instance of IBindStatusCallback.
dwReserved
[in] Reserved. Must be set to zero.

Return Values

Returns one of the following values:

S_OK
Success.
E_INVALIDARG
One or more parameters are invalid.
E_OUTOFMEMORY
There was insufficient memory to register the callback with the bind context.

Remarks

The IBindStatusCallback interface passed into the pBSCb parameter will receive callbacks on any binding operations using the bind context passed into the pbc parameter.

Only the last IBindStatusCallback interface that was registered to a particular bind context will receive callbacks. The implementation of IBindStatusCallback could pass the callbacks it receives to the previously registered IBindStatusCallback interface using the address of a pointer in the ppBSCBPrevious parameter.

Requirements

Pocket PC: Pocket PC 2000 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: urlmon.h
Library: urlmon.lib

Share via