IVMVirtualPC::GetConfigurationValue メソッド

[Windows Virtual PC は、Windows 8の時点で使用できなくなります。代わりに、 Hyper-V WMI プロバイダー (V2)を使用します。

指定した構成設定の値を取得します。

構文

HRESULT GetConfigurationValue(
  [in]          BSTR    preferenceKey,
  [out, retval] VARIANT *preferenceValue
);

preferenceKey [in]: 構成ファイルに格納されている基本設定を識別するために使用されるキー。
preferenceValue [out, retval]: 基本設定の値。このパラメーターには、VT_ARRAY VT_UI1(生バイト)、VT_BSTR| (文字列)、VT_I4 (整数)、またはVT_BOOL (Boolean) のいずれかの VARIANT 型を指定できます。

このメソッドは、これらの値のいずれかを返すことができます。

リターンコード/値	説明
S_OK 0	操作に成功しました。
E_POINTER 0x80004003	preferenceKey パラメーターまたは preferenceValue パラメーターが NULL です。
VM_E_PREF_NOT_FOUND 0xa0040300	設定が見つかりませんでした。
VM_E_HARDWARE_VIRTUALIZATION_DISABLED 0xA0040951	プロセッサは、ハードウェアアクセラレータ仮想化 (HAV) 拡張機能をサポートしていません。
DISP_E_EXCEPTION 0x80020009	予期しないエラーが発生しました。

このメソッドは、現在のユーザーの任意のユーザー設定値への低レベルのアクセスを提供します。これは、顧客定義キーの基本設定値を取得するために使用できます。

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
クライアントサポートの終了	Windows 7
製品	Windows Virtual PC
Header	VPCCOMInterfaces.h
IID	IID_IVMVirtualPCは 236ba0d9-a24a-4292-a132-27c1421dfd01 として定義されます