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 |