共用方式為

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

另請參閱

IWbemCoNtext

IWbemCoNtext：：BeginEnumeration

IWbemCoNtext：：GetValue