IFunctionDiscoveryProvider::EndQuery method (functiondiscoveryprovider.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.]

Terminates a query being executed by a provider.

Syntax

HRESULT EndQuery();

Return value

Possible return values include, but are not limited to, the following.

Return code Description
S_OK
The method completed successfully.
E_INVALIDARG
One of the parameters contains an invalid argument.

Remarks

This method is called by Function Discovery to indicate to a provider that no further query notifications will be sent to the IFunctionDiscoveryNotification callback interface. Implementers should try to ensure that no further query notifications are sent to Function Discovery after the call to EndQuery returns. If a provider implementation sends a notification after EndQuery returns, Function Discovery returns an error to the provider and the notification is not forwarded to the client.

EndQuery is only called when a client passed an IFunctionDiscoveryNotification interface passed to the provider's Initialize method.

Any data structures associated with the query can be deleted in the implementation of EndQuery. Any private context memory allocated by the Query method should also be deleted.

Note that Query can be invoked again once EndQuery has returned.

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header functiondiscoveryprovider.h

See also

IFunctionDiscoveryProvider