Export (0) Print
Expand All

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 codeDescription
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

 

 

Show:
© 2014 Microsoft