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：：EnumerateInstances 或 Provider：：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 |