IVMVirtualPC：：FindVirtualNetwork 方法

  • 發行項

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

擷取符合所要求名稱的虛擬網路物件。

語法

HRESULT FindVirtualNetwork(
  [in]          BSTR              virtualNetworkName,
  [out, retval] IVMVirtualNetwork **virtualNetwork
);

參數

virtualNetworkName [in]

要尋找的虛擬網路名稱。

virtualNetwork [out， retval]

代表此虛擬網路之新 IVMVirtualNetwork 物件的指標。

傳回值

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

傳回碼/值 描述
S_OK
0
 作業成功。
S_FALSE
1
 找不到指定的虛擬網路。
E_POINTER
0x80004003
 virtualNetwork參數為Null或找不到虛擬網路。
E_INVALIDARG
0x80000003
 virtualNetworkName參數無效或為空字串。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 找不到虛擬網路檔案。
DISP_E_EXCEPTION
0x80020009
 已發生未預期的錯誤。
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 處理器不支援硬體加速虛擬化 (HAV) 擴充功能。

備註

虛擬網路名稱不區分大小寫，例如，「MyNetwork」 和 「mynetwork」 是指相同的虛擬網路。

規格需求

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

另請參閱

IVMVirtualPC