CWbemProviderGlue：：GetInstanceByPath (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 從實例取得它。

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	wbemglue.h (include FwCommon.h)
程式庫	FrameDyn.lib
Dll	FrameDynOS.dll;FrameDyn.dll