通过

CWbemProviderGlue：：GetEmptyInstance (MethodContext*，LPCWSTR，CInstance**，LPCWSTR) 方法 (wbemglue.h)

  • 项目

[CWbemProviderGlue 类是 WMI 提供程序框架的一部分，现在视为处于最终状态，对于影响这些库的非安全性相关问题，将不会提供进一步的开发、增强或更新。 所有新开发均应使用 MI API。]

GetEmptyInstance 方法检索指定类的单个未填充实例。

语法

HRESULT GetEmptyInstance(
  MethodContext *pMethodContext,
  LPCWSTR       pszClassName,
  CInstance     **ppInstance,
  LPCWSTR       pszNamespace
);

参数

pMethodContext

指向当前上下文的指针。

pszClassName

要返回其实例的类的名称。

ppInstance

指向用于存储新实例的 CInstance 类实例的指针。 此指针必须由调用 GetEmptyInstance 的框架提供程序释放。

pszNamespace

pszClassName 指定的类名的命名空间。 此参数可以为 NULL ，以指示默认命名空间，即 root\cimv2。

返回值

如果操作成功，则返回 WBEM_S_NO_ERROR ， WBEM_E_OUT_OF_MEMORY 如果操作因内存不足而失败，则返回任何其他 HRESULT 错误代码。

注解

框架提供程序将提供程序的名称传递给 GetEmptyInstance，这将返回一个空实例。 此方法的常见用途是填充嵌入的对象属性。 此方法与 CInstance：：SetEmbeddedObject 结合使用。

不建议使用第二个函数原型。 它仅用于支持现有代码。

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 wbemglue.h (包括 FwCommon.h)
Library FrameDyn.lib
DLL FrameDynOS.dll;FrameDyn.dll