IFunctionDiscoveryNotification::OnError method (functiondiscoveryapi.h)
[Function Discovery is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]
Receives errors that occur during asynchronous query processing.
Syntax
HRESULT OnError(
[in] HRESULT hr,
[in] FDQUERYCONTEXT fdqcQueryContext,
[in] const WCHAR *pszProvider
);
Parameters
[in] hr
The query error that is being reported.
[in] fdqcQueryContext
The context registered for change notification. The type FDQUERYCONTEXT is defined as a DWORDLONG.
[in] pszProvider
The name of the provider.
Return value
The client program's implementation of the OnError method should return one of the following HRESULT values to the caller.
Return code | Description |
---|---|
|
The method completed successfully. |
|
The value of one of the input parameters is invalid. |
Remarks
Typically, clients will expect that any asynchronous error is fatal and that the query will stop returning results, but custom provider documentation could indicate otherwise for specific error codes.
Do not call Release on the query object from this method. Doing so could cause a deadlock. If Release is called on a query object from another thread while a callback is in process, the object will not be released until the callback has finished.
All notifications passed to Function Discovery by providers are queued and returned to the client one by one. Callbacks are synchronized so that a client will only receive one notification at a time.
Because other IFunctionDiscoveryNotification method calls may be made in other threads, any changes made to the thread state during the call must be restored before exiting the method.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2008 [desktop apps only] |
Target Platform | Windows |
Header | functiondiscoveryapi.h |