Share via

IVMVirtualMachine：：SetConfigurationValue 方法

  • 發行項

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

設定此虛擬機器的指定組態設定值， (VM) 。

語法

HRESULT SetConfigurationValue(
  [in] BSTR    configurationKey,
  [in] VARIANT configurationValue
);

參數

configurationKey [in]

用來將組態值識別為儲存在 「*.vmc」 檔案中的索引鍵。

重要

只有在使用 SetConfigurationValue 方法時，才應該對 「*.vmc」 進行變更。 不支援使用任何其他方法變更 「*.vmc」。

configurationValue [in]

組態值。 這個值 cay 是下列VARIANT類型的其中一種：VT_ARRAY|VT_UI1 (原始位元組) 、VT_BSTR (字串) 、VT_UI4 (整數) 或VT_BOOL (布林值) 。

傳回值

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

傳回碼/值 描述
S_OK
0
 作業成功。
E_INVALIDARG
0x80000003
 configurationKey參數為Null或空白，或configurationValue參數不是有效的 Variant 類型。
VM_E_VM_UNKNOWN
0xA0040207
 組態未知。
DISP_E_EXCEPTION
0x80020009
 已發生未預期的錯誤。

備註

configurationKey參數支援下列值。

configurationKey 值 描述 資料類型 預設值
「hardware/bios/time_sync_at_boot」
 如果 VM USB 時鐘要與開機時主機時鐘同步，則為 「true」 ;否則為 「false」。
 「boolean」
 "true"
「integration/microsoft/host_time_sync/enabled」」
 如果整合元件中已啟用主機時間同步處理，則為 「true」;否則為 「false」。
 「boolean」
 "true"
「ui_options/auto_app_publish」
 如果在整合元件中啟用自動發佈應用程式，則為 「true」 ;否則為 「false」。 這也稱為虛擬應用程式。
 「boolean」
 "true"
「ui_options/seconds_to_save」
 在關閉所有應用程式之後儲存 VM 之前，等待的秒數。 不過，低於 20 和大於 4，294，968 的值具有特殊意義。 如需詳細資訊，請參閱下列清單
0
永不儲存 VM。
1 20
等候 20 秒，再儲存 VM。
21 4,294,967
等候指定的秒數，再儲存 VM。
4,294,968 4,294,967,295
儲存 VM 之前，請等候 4，294，968 秒。
 「integer」
 300

此方法提供任何組態值的低階存取。 它可以用來設定客戶定義索引鍵的組態值。 如果您使用此方法來設定系統組態值，請小心，因為組態值上不會執行任何錯誤檢查。 此外，當虛擬機器正在執行時，無法變更某些組態值。

組態機碼位於虛擬機器的 「*.vmc」 檔案中，格式為 XML。 金鑰會以與 Windows 中的登錄機碼類似的階層式方式儲存。 若要指定特定子機碼，會建構「索引鍵路徑」，以斜線標記分隔格式指定各種索引鍵。

例如，若要設定位於下列索引鍵樹狀目錄中的 「ram_size」 索引鍵值：

<preferences>
  <hardware>
    <bios>
      <time_sync_at_boot type="boolean">true</time_sync_at_boot>

configurationKey路徑字串會指定如下：

"hardware/memory/ram_size"

如果所需樹狀結構中的任何索引鍵具有 「id」 屬性值，則屬性及其值會立即內嵌在 configurationKey 路徑字串中，並使用下列括弧格式：「[@id=」id_value「]」。

例如，若要設定位於下列索引鍵樹狀目錄中的「存回」 索引鍵值：

<preferences>
  <alpha>
    <bravo>
      <charlie>
        <delta id="1">
          <echo id="0">
            <foxtrot>
              <golf type="string">D</golf>

configurationKey路徑字串會指定如下：

"alpha/bravo/charlie/delta[@id=1]/echo[@id=0]/foxtrot/golf"

規格需求

需求 值
最低支援的用戶端
 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器
 都不支援
用戶端支援結束
 Windows 7
產品
 Windows Virtual PC
標頭
HTTPCOMInterfaces.h
IID
 IID_IVMVirtualMachine定義為 f7092aa1-33ed-4f78-a59f-c00adfc2edd7

另請參閱

IVMVirtualMachine

IVMVirtualPC：：SetConfigurationValue