Share via

IVMVirtualMachine：：GetConfigurationValue 方法

  • 發行項

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

擷取這個虛擬機器之指定組態設定的值。

語法

HRESULT GetConfigurationValue(
  [in]          BSTR    configurationKey,
  [out, retval] VARIANT *configurationValue
);

參數

configurationKey [in]

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

configurationValue [out， retval]

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

傳回值

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

傳回碼/值 描述
S_OK
0
 作業成功。
E_INVALIDARG
0x80000003
 configurationKey參數為Null或空白。
E_POINTER
0x80004003
 configurationValue參數為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
標頭
HTTPCOMInterfaces.h
IID
 IID_IVMVirtualMachine定義為 f7092aa1-33ed-4f78-a59f-c00adfc2edd7

另請參閱

IVMVirtualMachine