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 キーに次のレジストリ文字列値が設定されます。

  • HostName
  • PhysicalHostName
  • PhysicalHostNameFullyQualified
  • VirtualMachineName

必要条件

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

関連項目

IVMGuestOS