[This is preliminary documentation and subject to change.]
The IWbemServices::ExecQueryAsync method performs the same task as IWbemServices::ExecQuery except that the result set is supplied to the specified response handler.
For the valid types of queries that can be performed, see Queries.
HRESULT IWbemServices::ExecQueryAsync(
[in] BSTR bstrQueryLanguage,
[in] BSTR bstrQuery,
[in] LONG lFlags,
[in] IWbemContext *pCtx,
[in] CALLBACK *pResponseHandler
);
If the query is very broad and involves many instance providers, it is not practical to include enough context information for all providers. In these cases, it is recommended that the parameter be NULL.
For a detailed explanation of this parameter, see Asynchronous Methods.
CIMOM only calls AddRef to the pointer in cases where WBEM_NO_ERROR is returned. In cases where an error code is returned, the reference count is the same as on entry.
WBEM_E_FAILED | Other unspecified errors. |
WBEM_E_INVALID_CLASS | The specified class was invalid. |
WBEM_E_INVALID_PARAMETER | An invalid parameter was specified or the namespace could not be parsed. |
WBEM_E_OUT_OF_MEMORY | There was not enough memory to complete the operation. |
WBEM_E_TRANSPORT_FAILURE | The communications link between the client and CIMOM has failed. |
WBEM_NO_ERROR | The call succeeded. |
On failure, you can obtain any available information from the COM function GetErrorInfo.
Other error codes are returned to the object sink specified by the pResponseHandler parameter.
Asynchronous Methods, IWbemServices::ExecQuery, Queries