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

Requirement	Value
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