IVMGuestOS：：GetParameter 方法

  • 發行項

[Windows 虛擬電腦已不再可供Windows 8使用。 請改用 Hyper-V WMI 提供者 (V2) 。]

擷取客體作業系統內的具名參數。

語法

HRESULT GetParameter(
  [in]          BSTR inParameterName,
  [out, retval] BSTR *outParameterValue
);

參數

inParameterName [in]

參數名稱。 長度必須介於 1 到 255 個字元之間，而且不能包含反斜線 (\) 字元。

outParameterValue [out， retval]

參數值。

傳回值

這個方法可以傳回下列其中一個值。

傳回碼/值 描述
S_OK
0
 作業成功。
E_INVALIDARG
0x80000003
 參數無效或未指定。
E_POINTER
0x80004003
 參數為 Null。
VM_E_TIMED_OUT
0xA0040202
 作業未及時完成。
VM_E_VM_NOT_RUNNING
0xA0040206
 虛擬機器未執行。
VM_E_VM_PAUSED
0xA00400507
 虛擬機器已暫停。
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 此虛擬機器中未安裝整合元件。
DISP_E_EXCEPTION
0x80020009
 已發生未預期的錯誤。

備註

叫用此方法時，虛擬機器必須執行，而且必須安裝整合元件。 只有以 Windows 為基礎的客體作業系統才支援這個方法。

安裝整合元件後，系統會自動將下列機碼新增至客體作業系統的登錄：

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Virtual Machine\Guest\Parameters

客體作業系統啟動時， 參數 機碼中會填入下列登錄字串值：

  • HostName
  • PhysicalHostName
  • PhysicalHostNameFullyQualified
  • VirtualMachineName

規格需求

需求 值
最低支援的用戶端
 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器
 都不支援
用戶端支援結束
 Windows 7
產品
 Windows Virtual PC
標頭
VPCOMInterfaces.h
IID
 IID_IVMGuestOS定義為 99fea0db-4880-499a-b6d8-73dff9bc91be

另請參閱

IVMGuestOS