IVMVirtualMachine::SetActivationValue メソッド

  • [アーティクル]

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

この仮想マシンの指定したアクティブ化設定の値を設定します。

構文

HRESULT SetActivationValue(
  [in] BSTR    activationKey,
  [in] VARIANT activationValue
);

パラメーター

activationKey [in]

"*.vmc" ファイルに格納されているアクティブ化値を識別するために使用されるキー。

activationValue [in]

アクティブ化の値。 この値には、VT_ARRAY VT_UI1(生バイト)、VT_BSTR| (文字列)、VT_UI4 (整数)、またはVT_BOOL (ブール値) のいずれかの VARIANT 型 を指定できます。

戻り値

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

リターン コード/値 説明
S_OK
0
 操作に成功しました。
E_INVALIDARG
0x80000003
 activationKey パラメーターが NULL または空であるか、activationValue パラメーターが有効なバリアント型ではありません。
VM_E_VM_UNKNOWN
0xA0040207
 構成が不明です。
VM_E_PREF_NOT_FOUND
0xA0040300
 構成に有効なアクティブ化がありません。
DISP_E_EXCEPTION
0x80020009
 予期しないエラーが発生しました。

解説

このメソッドは、任意のアクティブ化値に対する低レベルのアクセスを提供します。 これを使用して、顧客定義キーのアクティブ化値を設定できます。 このメソッドを使用してシステムのアクティブ化値を設定する場合は、アクティブ化値に対してエラー チェックが実行されないので注意してください。 また、仮想マシンの実行中は、一部のアクティブ化値を変更できません。 仮想マシンを起動すると、その構成値でコピーが作成され、アクティブ化値のセットになります。 アクティブ化の値は、仮想マシンがシャットダウンまたは再起動されるまで保持されます。 Windows Virtual PC では、特定のキーの値を格納するためにのみ構成を使用できます。つまり、アクティブ化の値を使用することはできません。

Note

アクティブ化の値を変更するには、仮想マシン セッションが実行されている必要があります。

アクティブ化キーは、Windows のレジストリ キーと同様の階層的な方法で内部的に格納されます。 特定のサブキーを指定するために、さまざまなキーをスラッシュで区切られた形式で指定する "キー パス" が構築されます。

たとえば、次のキー ツリーにある "default_action" キーの値を設定します。

<settings>
    <undo_drives>
        <default_action type="integer">1</default_action>

activationKey パス文字列は、次のように指定します。

"settings/undo_drives/default_action"

必要条件

要件 値
サポートされている最小のクライアント
 Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー
 サポートなし
クライアント サポートの終了
 Windows 7
製品
 Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
 IID_IVMVirtualMachineは f7092aa1-33ed-4f78-a59f-c00adfc2edd7 として定義されています

関連項目

IVMVirtualMachine