IWbemCoNtext::GetNames 方法 (wbemcli.h)
IWbemCoNtext::GetNames方法會傳回具名內容值之所有名稱的SAFEARRAY結構。 已知所有名稱之後,可以在每個名稱上呼叫 GetValue 來擷取值。 這項技術是存取與呼叫 BeginEnumeration、 Next和 EndEnumeration 方法不同的內容值的方式。
語法
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 |