Share via

IVMVirtualMachine：：RemoveActivationValue 方法

  • 發行項

[Windows 虛擬電腦已不再可供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 虛擬電腦只能使用設定來儲存特定金鑰的值，也就是說，可能永遠不會使用啟用值。

注意

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

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

另請參閱

IVMVirtualMachine