Share via

IVMVirtualMachine：：RemoveConfigurationValue 方法

  • 發行項

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

移除這個虛擬機器的指定組態設定值。

語法

HRESULT RemoveConfigurationValue(
  [in] BSTR configurationKey
);

參數

configurationKey [in]

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

傳回值

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

傳回碼/值 描述
S_OK
0
 作業成功。
E_INVALIDARG
0x80000003
 參數為 Null 或空白。
VM_E_VM_UNKNOWN
0xA0040207
 組態未知。
VM_E_PREF_NOT_FOUND
0xA0040300
 找不到喜好設定。
DISP_E_EXCEPTION
0x80020009
 已發生未預期的錯誤。

備註

此方法提供任何組態值的低階存取。 它可以用來移除客戶定義索引鍵的組態值。 如果您使用這個方法來移除系統組態值，請小心，因為虛擬機器執行時無法變更某些值。

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

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

<hardware>
    <memory>
        <ram_size type="integer">128</ram_size>

configurationKey路徑字串會指定如下：

"hardware/memory/ram_size"

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

例如，若要移除位於下列索引鍵樹狀目錄中的 「absolute」 索引鍵值：

<hardware>
    <pci_bus>
        <ide_adapter>
            <ide_controller id="1">
                <location id="0">
                    <pathname>
                        <absolute type="string">D</absolute>

configurationKey路徑字串會指定如下：

"hardware/pci_bus/ide_adapter/ide_controller[@id=1]/location[@id=0]/pathname/absolute"

規格需求

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

另請參閱

IVMVirtualMachine