Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This 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 IBindCtxinterface from which to receive callbacks.

pbsc

[in] Address of the IBindStatusCallbackinterface 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

This function returns one of the values shown in the following table.

Value Description

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 IBindStatusCallbackinterface passed into the pbscparameter will receive callbacks on any binding operations using the bind context passed into the pbcparameter.

Only the last IBindStatusCallbackinterface that was registered to a particular bind context will receive callbacks. The implementation of IBindStatusCallbackcould pass the callbacks it receives to the previously registered IBindStatusCallbackinterface using the address of a pointer in the ppbscPreviousparameter.

Requirements

Header urlmon.h, urlmon.idl
Library urlmon.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later