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

備註

這個方法會使用部分實例更新作業，只要求指定物件的指定屬性。 這是擷取特定實例的最有效率方式，比只需要索引鍵更多的屬性。 請注意，並非所有提供者都支援部分實例作業。 在此情況下，會填入整個實例 (包括索引鍵) 。 如需詳細資訊，請參閱 支援 Partial-Instance 作業。

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

規格需求

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

另請參閱

CWbemProviderGlue

GetInstanceByPath

GetInstanceKeysByPath