CWbemProviderGlue::GetInstancePropertiesByPath 方法 (wbemglue.h)

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

GetInstancePropertiesByPath 方法检索由特定对象路径标识的实例,其中仅填充了指定的属性。 要填充的属性在 CHString 数组中命名。

语法

HRESULT GetInstancePropertiesByPath(
        LPCWSTR         pszInstancePath,
        CInstance       **ppInstance,
        MethodContext   *pMethodContext,
  [ref] CHStringArray & csaProperties
);

参数

pszInstancePath

要返回的实例的对象路径。 此参数必须指向完整路径。

ppInstance

指向新 CInstance 实例的指针的指针,该实例的键由 pszInstancePath 指定。 执行请求的框架提供程序必须释放此指针。

pMethodContext

指向当前上下文的指针。 必须提供上下文以防止死锁。 使用由 Provider::EnumerateInstancesProvider::ExecQuery 传入提供程序的上下文,或使用 CInstance::GetMethodContext 从实例获取上下文。 此参数不得为 NULL

[ref] csaProperties

一个数组,其中包含要复制到新实例的属性的名称。

返回值

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

注解

此方法使用部分实例更新操作来仅请求指定对象的指定属性。 当需要的属性多于键时,这是检索特定实例的最有效方法。 请注意,并非所有提供程序都支持部分实例操作。 在这种情况下,将填充整个实例 (包括密钥) 。 有关详细信息,请参阅 支持 Partial-Instance 操作

在提供程序框架的当前版本中, pszInstancePath 必须解析为同一计算机上的实例路径。

要求

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

另请参阅

CWbemProviderGlue

GetInstanceByPath

GetInstanceKeysByPath