IVMVirtualMachine::GetActivationValue メソッド

  • [アーティクル]

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

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

構文

HRESULT GetActivationValue(
  [in]          BSTR    activationKey,
  [out, retval] VARIANT *activationValue
);

パラメーター

activationKey [in]

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

activationValue [out, retval]

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

戻り値

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

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

解説

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

アクティブ化キーは、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