RegisterBindStatusCallback
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 IBindCtx interface from which to receive callbacks.
- 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
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 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.
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 |