描述

 

IWbemServices.CreateInstanceEnumAsync方法创建一个枚举器，根据用户指定的选择条件异步返回指定类的实例。此方法支持简单的WMI查询语言（WQL）查询。可以使用IWbemServices.ExecQueryAsync方法处理更复杂的查询。

 

C++ 语法

 

 

PowerBASIC 语法

 

 

参数

 

strClass

 

有效BSTR包含需要实例的类的名称。此参数不能为NULL。

 

lFlags

 

此参数可以是以下值之一。

 

 

pCtx

 

通常为NULL。否则，这是指向可以由提供者提供请求的实例的IWbemContext对象的指针。必须在相关提供者的文档中指定上下文对象中的值。

 

pResponseHandler

 

指向呼叫者执行IWbemObjectSink的指针。该处理程序在对象可用时接收对象。如果返回任何错误代码，则不使用提供的IWbemObjectSink指针。如果返回WBEM_S_NO_ERROR，则将调用用户的IWbemObjectSink实现来指示操作的结果。如果WBEM_S_NO_ERROR返回，Windows Management只会调用该指针的AddRef.在错误代码返回的情况下，引用计数与输入相同。

 

返回值

 

此方法返回一个HRESULT，指示方法调用的状态。下表列出了HRESULT中包含的值。

 

失败时，您可以从COM函数GetErrorInfo获取更多信息。

 

如果网络问题导致您失去与Windows Management的远程连接，也可能会返回COM特定的错误代码。

 

实例提供商可以通过CreateInstanceEnumAsync的返回代码或通过pResponseHandler进行的SetStatus呼叫来报告成功或失败。如果您选择致电SetStatus，则通过pResponseHandler发送的返回码优先。

 

如果CreateInstanceEnumAsync返回WBEM_S_NO_ERROR，则WMI等待来自响应处理程序的SetStatus方法的结果。WMI在本地连接上无限期地等待，或者直到发生远程连接超时。

 

 

示例代码

 

以下示例说明如何实现CreateInstanceEnumAsync.

 

#define NUM_OF_INSTANCES 3

 

HRESULT CStdProvider::CreateInstanceEnumAsync(

          /* [in] */ BSTR strClass,

          /* [in] */ long lFlags,

          /* [in] */ IWbemContext __RPC_FAR *pCtx,

          /* [in] */ IWbemObjectSink __RPC_FAR *pResponseHandler

          )

{

  IWbemClassObject *pClass = 0;

  IWbemClassObject *pNextInst = 0;

 

  // Assume there is an IWbemServices pointer available to

  // retrieve the class definition.

  HRESULT hRes = m_pSvc->GetObject(strClass, 0, NULL, &pClass, 0);

  if (hRes)

      return hRes;

 

  // Now loop through the private source and create each instance.

  for (int i = 0; i < NUM_OF_INSTANCES; i++)

  {

       // Prepare an empty object to receive the class definition.

       pClass->SpawnInstance(0, &pNextInst);

 

       // Create the instance.

       // For example, create the instance in a

       // FillInst method you implement:

       /*FillInst(pNextInst);*/

 

       // Deliver the class to WMI.

       pResponseHandler->Indicate(1, &pNextInst);

       pNextInst->Release();

  }

 

  // Send a finish message to WMI.

  pResponseHandler->SetStatus(0, WBEM_S_NO_ERROR, 0, 0);

 

  // Free memory resources.

  SysFreeString(strClass);

  pClass->Release();

  m_pSvc->Release();

 

  return WBEM_S_NO_ERROR;

}

 

在前面的示例中，实例提供者从WMI获取一个线程来执行任何必要的操作。您可能想要调用sink AddRef方法，并创建另一个线程来传递结果集中的对象。创建另一个线程允许当前线程返回到WMI，而不会耗尽线程池。提供者是否通过双线程设计选择单线程设计取决于提供商计划使用WMI线程的时间。没有固定的规则。实验可以帮助您确定设计如何影响WMI性能。

 

备注

 

调用IWbemObjectSink.SetStatus方法来指示结果集的结束。也可以调用它，而不会对IWbemObjectSink进行任何调用：指示是否发生错误条件。

 

因为回调可能不会在客户端要求的相同身份验证级别返回，建议您使用半异步而不是异步通信。

 

有关详细信息，请参阅IWbemServices.CreateInstanceEnum和调用方法.

 

要求