Share via


RegisterBindStatusCallback function

Registers a callback interface with an existing bind context.

Syntax

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

Parameters

  • pbc [in]
    A pointer to the IBindCtx interface from which to receive callbacks.

  • pbsc [in]
    A pointer to the IBindStatusCallback interface implementation to be registered.

  • ppbscPrevious [out]
    A pointer to a previously registered instance of IBindStatusCallback. May be NULL.

  • dwReserved [in]
    Reserved. Must be set to 0.

Return value

Returns one of the following values.

Return code Description
S_OK

Successful.

E_FAIL

No new callbacks allowed after binding has started.

E_INVALIDARG

One or more parameters is invalid.

E_OUTOFMEMORY

There is insufficient memory to register the callback with the bind context.

 

Remarks

The IBindStatusCallback interface passed into the pbsc parameter receives callbacks on any binding operations that uses the bind context passed into the pbc parameter.

More than one IBindStatusCallback can be registered at a time. Each callback is notified in sequence. If the ppbscPrevious parameter is specified, the previously registered IBindStatusCallback interface is removed from the list and returned. The caller would then be responsible for forwarding any binding events it receives to the previous handler, if wanted.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Product

Internet Explorer 3.0

Header

Urlmon.h

Library

Urlmon.lib

DLL

Urlmon.dll

See also

RevokeBindStatusCallback