共用方式為


IWbemCoNtext::GetNames 方法 (wbemcli.h)

IWbemCoNtext::GetNames方法會傳回具名內容值之所有名稱的SAFEARRAY結構。 已知所有名稱之後,可以在每個名稱上呼叫 GetValue 來擷取值。 這項技術是存取與呼叫 BeginEnumerationNextEndEnumeration 方法不同的內容值的方式。

語法

HRESULT GetNames(
  [in]  long      lFlags,
  [out] SAFEARRAY **pNames
);

參數

[in] lFlags

保留的。 此參數必須是 0。

[out] pNames

此參數不可為 Null,但在進入時必須指向 Null。 如果沒有傳回錯誤,在結束 pstrNames 時,會收到類型為新 SAFEARRAY 結構的指標,VT_BSTR包含所有內容值名稱。 當不再需要陣列時,呼叫端必須在傳回的指標上呼叫 SafeArrayDestroy 。 如果傳回錯誤碼,指標會保持未修改。

注意 如果 物件中沒有具名值,則呼叫會成功,並傳回長度為 0 的陣列。
 

傳回值

這個方法會傳回 HRESULT ,指出方法呼叫的狀態。 下列清單列出 HRESULT中包含的值。

備註

如需使用BSTR值的SAFEARRAY結構的詳細資訊,請參閱擷取 WMI 實例的一部分

規格需求

   
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 wbemcli.h (包含 Wbemidl.h)
程式庫 Wbemuuid.lib
Dll Esscli.dll;Fastprox.dll;FrameDyn.dll;FrameDynOS.dll;Wbemcomn.dll;Wbemcore.dll;Wbemess.dll;Wmipjobj.dll

另請參閱

IWbemCoNtext

IWbemCoNtext::BeginEnumeration

IWbemCoNtext::GetValue