IVMVirtualPC：：SetConfigurationValue 方法

  • 發行項

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

設定指定組態設定的值。

語法

HRESULT SetConfigurationValue(
  [in] BSTR    preferenceKey,
  [in] VARIANT preferenceValue
);

參數

preferenceKey [in]

用來識別喜好設定的索引鍵，如儲存在 「%LocalAppData%\Microsoft\Windows 虛擬電腦」 中的每個使用者組態檔 (Options.xml 中) 。

重要

只有在使用 SetConfigurationValue 方法時，才應該變更Options.xml。 不支援使用任何其他方法變更Options.xml。

preferenceValue [in]

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

傳回值

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

傳回碼/值 描述
S_OK
0
 作業成功。
E_POINTER
0x80004003
 preferenceKey或preferenceValue參數為Null。
E_INVALIDARG
0x80000003
 preferenceKey參數無效或為空字串。
DISP_E_EXCEPTION
0x80020009
 已發生未預期的錯誤。
E_ACCESSDENIED
0x80070005
 目前的使用者沒有足夠的組態檔存取權。
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 處理器不支援硬體加速虛擬化 (HAV) 擴充功能。

備註

preferenceKey參數支援下列值。

preferenceKey 值 描述 資料類型 預設值
「idle_timeout」
 如果沒有使用 Windows 虛擬電腦介面的作用中 VM 或應用程式，vpc.exe應該等候的秒數。
 「integer」
 "30"

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

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

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

<preferences>
  <idle_timeout type="integer">60</idle_timeout>

preferenceKey路徑字串會指定如下：

"idle_timeout"

如果所需的樹狀結構中的任何索引鍵具有 「id」 屬性值，則屬性及其值會立即內嵌在其相關聯的組態索引鍵之後，使用下列括弧格式：「[@id=」id_value「]」。

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

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

preferenceKey路徑字串會指定如下：

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

規格需求

需求 值
最低支援的用戶端
 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器
 都不支援
用戶端支援結束
 Windows 7
產品
 Windows Virtual PC
標頭
HTTPCOMInterfaces.h
IID
 IID_IVMVirtualPC定義為 236ba0d9-a24a-4292-a132-27c1421dfd01

另請參閱

IVMVirtualPC

IVMVirtualMachine：：SetConfigurationValue