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，如果作業因記憶體不足或任何其他HRESULT錯誤碼而失敗，WBEM_E_OUT_OF_MEMORY。

備註

GetInstanceByPath方法可讓架構提供者從另一個提供者存取資料，而不需要 WMI API 呼叫。 架構提供者會將 實例的物件路徑傳遞至 GetInstanceByPath，這會傳回 實例。

在提供者架構的目前版本中， pszInstancePath 必須解析為相同電腦上的實例路徑。

雖然 pMethodCoNtext 的預設值為 Null，但必須提供內容以防止死結。 使用 由 Provider：：EnumerateInstances 或 Provider：：ExecQuery傳遞至提供者的內容，或使用 CInstance：：GetMethodCoNtext從實例取得它。

規格需求