共用方式為

IVMVirtualMachine：：SetActivationValue 方法

  • 發行項

[Windows 虛擬電腦已不再可供Windows 8使用。 請改用 Hyper-V WMI 提供者 (V2) 。]

設定這個虛擬機器的指定啟用設定值。

語法

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

參數

activationKey [in]

用來將啟用值識別為儲存在 「*.vmc」 檔案中的金鑰。

activationValue [in]

啟用值。 此值可以是下列VARIANT類型的其中一種：VT_ARRAY|VT_UI1 (原始位元組) 、VT_BSTR (字串) 、VT_UI4 (整數) 或VT_BOOL (布林值) 。

傳回值

這個方法可以傳回其中一個值。

傳回碼/值 描述
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 虛擬電腦只能使用設定來儲存特定金鑰的值，也就是說，可能永遠不會使用啟用值。

注意

虛擬機器會話必須先執行，才能變更任何啟用值。

啟用金鑰會以類似于 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
標頭
HTTPCOMInterfaces.h
IID
 IID_IVMVirtualMachine定義為 f7092aa1-33ed-4f78-a59f-c00adfc2edd7

另請參閱

IVMVirtualMachine