IVMVirtualMachine::RemoveActivationValue メソッド

  • [アーティクル]

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

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

構文

HRESULT RemoveActivationValue(
  [in] BSTR activationKey
);

パラメーター

activationKey [in]

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

戻り値

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

リターン コード/値 説明
S_OK
0
 操作に成功しました。
E_INVALIDARG
0x80000003
 パラメーターが 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