RegisterBindStatusCallback Function

---

Registers a callback interface with an existing bind context.

Syntax

HRESULT RegisterBindStatusCallback(
    IBindCtx *pbc,
    IBindStatusCallback *pbsc,
    IBindStatusCallback **ppbscPrevious,
    DWORD  dwReserved
);

Parameters

pbc

[in] Address of the IBindCtx interface to receive callbacks from.

pbsc

[in] Address of the IBindStatusCallback interface implementation to be registered.

ppbscPrevious

[out] Address of a pointer to a previously registered instance of IBindStatusCallback.

dwReserved

[in] Reserved. Must be set to zero.

Return Value

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 pbsc 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 ppbscPrevious parameter.

Function Information

Windows NT	Use version 4.0. Implemented as a Unicode function.
Windows	Use Windows 95 and later. Implemented as a Unicode function.
Header	Urlmon.h
Import Library	Urlmon.lib
Minimum availability	Internet Explorer 3.0

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0

See Also

RevokeBindStatusCallback