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

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

GetInstanceByPath 方法通过调用提供程序 GetObject 方法检索由特定对象路径标识的实例。

语法

HRESULT GetInstanceByPath(
  LPCWSTR       pszObjectPath,
  CInstance     **ppInstance,
  MethodContext *pMethodContext
);

pszObjectPath

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

ppInstance

指向用于存储新实例的 CInstance 实例的指针的指针。执行请求的框架提供程序必须释放此指针。

pMethodContext

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

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

GetInstanceByPath 方法允许框架提供程序从另一个提供程序访问数据，而无需 WMI API 调用。框架提供程序将实例的对象路径传递给 GetInstanceByPath，后者返回实例。

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

尽管 pMethodContext 的默认值为 NULL，但必须提供上下文以防止死锁。使用由 Provider：：EnumerateInstances 或 Provider：：ExecQuery 传入提供程序的上下文，或使用 CInstance：：GetMethodContext 从实例获取上下文。