次の方法で共有

IVMVirtualPC::SetConfigurationValue メソッド

  • [アーティクル]

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

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

構文

HRESULT SetConfigurationValue(
  [in] BSTR    preferenceKey,
  [in] VARIANT preferenceValue
);

パラメーター

preferenceKey [in]

ユーザーごとの構成ファイル ("%LocalAppData%\Microsoft\Windows Virtual PC" にOptions.xml) に格納されている基本設定を識別するために使用されるキー。

重要

Options.xmlに対する変更は 、SetConfigurationValue メソッドのみを使用して行う必要があります。 他の方法を使用したOptions.xmlの変更はサポートされていません。

preferenceValue [in]

基本設定の値。 この値は、VT_ARRAYVT_UI1 (未加工バイト)、VT_BSTR| (文字列)、VT_UI4 (整数)、またはVT_BOOL (Boolean) のいずれかの VARIANT 型 です。

戻り値

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

リターン コード/値 説明
S_OK
0
 操作に成功しました。
E_POINTER
0x80004003
 preferenceKey パラメーターまたは preferenceValue パラメーターが NULL です。
E_INVALIDARG
0x80000003
 preferenceKey パラメーターが無効であるか、空の文字列です。
DISP_E_EXCEPTION
0x80020009
 予期しないエラーが発生しました。
E_ACCESSDENIED
0x80070005
 現在のユーザーは、構成ファイルへのアクセスが不十分です。
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 プロセッサは、ハードウェア アクセラレータ仮想化 (HAV) 拡張機能をサポートしていません。

解説

preferenceKey パラメーターでは、次の値がサポートされています。

preferenceKey 値 説明 データの種類 既定値
"idle_timeout"
 Windows Virtual PC インターフェイスを使用するアクティブな VM またはアプリケーションがない場合、vpc.exeが終了するまで待機する必要がある秒数。
 "integer"
 "30"

このメソッドは、任意の構成値に対する低レベルのアクセスを提供します。 これを使用して、顧客定義キーの構成値を設定できます。 このメソッドを使用してシステム構成値を設定する場合は、構成値に対してエラー チェックが実行されないため、注意してください。 また、仮想マシンの実行中は、一部の構成値を変更できません。

構成キーは、仮想マシンの "Options.xml" ファイルに XML 形式で配置されます。 キーは、Windows のレジストリ キーと同様の階層的な方法で格納されます。 特定のサブキーを指定するために、さまざまなキーをスラッシュで区切られた形式で指定する "キー パス" が構築されます。

たとえば、次のキー ツリーにある "idle_timeout" キーの値を設定するには、

<preferences>
  <idle_timeout type="integer">60</idle_timeout>

preferenceKey パス文字列は、次のように指定されます。

"idle_timeout"

目的のツリー内のいずれかのキーに "id" 属性値がある場合、属性とその値は、関連付けられた構成キーの直後に、かっこで囲まれた形式 "[@id="id_value"] を使用して preferenceKey パス文字列に埋め込まれます。

たとえば、次のキー ツリーにある "golf" キーの値を設定するには、

<preferences>
  <alpha>
    <bravo>
      <charlie>
        <delta id="1">
          <echo id="0">
            <foxtrot>
              <golf type="string">D</golf>

preferenceKey パス文字列は、次のように指定されます。

"alpha/bravo/charlie/delta[@id=1]/echo[@id=0]/foxtrot/golf"

必要条件

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

関連項目

IVMVirtualPC

IVMVirtualMachine::SetConfigurationValue