CWbemProviderGlue：：GetInstanceKeysByPath 方法 (wbemglue.h)

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

GetInstanceKeysByPath 方法检索由特定对象路径标识的实例，其中仅填充了键属性。

语法

HRESULT GetInstanceKeysByPath(
  LPCWSTR       pszInstancePath,
  CInstance     **ppInstance,
  MethodContext *pMethodContext
);

pszInstancePath

要返回的实例的对象路径。

ppInstance

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

pMethodContext

指向当前上下文的指针。必须提供上下文以防止死锁。使用 Provider：：EnumerateInstances 或 Provider：：ExecQuery 传递到提供程序的上下文，或使用 CInstance：：GetMethodContext 从实例获取该上下文。此参数不得为 NULL。

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

此方法使用部分实例更新操作来仅请求指定对象的键属性。这是验证特定对象是否存在的最有效方法。请注意，并非所有提供程序都支持部分实例操作。在这种情况下，将填充整个实例。有关详细信息，请参阅支持 Partial-Instance 操作。

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