IVMGuestOS::GetParameter メソッド

[Windows Virtual PC は、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

ゲストオペレーティングシステムが起動すると、 Parameters キーに次のレジストリ文字列値が設定されます。

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
クライアントサポートの終了	Windows 7
製品	Windows Virtual PC
Header	VPCCOMInterfaces.h
IID	IID_IVMGuestOSは 99fea0db-4880-499a-b6d8-73dff9bc91be として定義されています