/* $Id: VBoxManageUtils.cpp 88087 2021-03-11 13:00:16Z vboxsync $ */ /** @file * VBoxManageUtils.h - VBoxManage utility functions. */ /* * Copyright (C) 2006-2021 Oracle Corporation * * This file is part of VirtualBox Open Source Edition (OSE), as * available from http://www.virtualbox.org. This file is free software; * you can redistribute it and/or modify it under the terms of the GNU * General Public License (GPL) as published by the Free Software * Foundation, in version 2 as it comes in the "COPYING" file of the * VirtualBox OSE distribution. VirtualBox OSE is distributed in the * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind. */ #ifndef VBOX_ONLY_DOCS #include "VBoxManageUtils.h" #include #include #include #include #include using namespace com; unsigned int getMaxNics(const ComPtr &pVirtualBox, const ComPtr &pMachine) { ULONG NetworkAdapterCount = 0; do { HRESULT rc; ComPtr info; CHECK_ERROR_BREAK(pVirtualBox, COMGETTER(SystemProperties)(info.asOutParam())); ChipsetType_T aChipset; CHECK_ERROR_BREAK(pMachine, COMGETTER(ChipsetType)(&aChipset)); CHECK_ERROR_BREAK(info, GetMaxNetworkAdapters(aChipset, &NetworkAdapterCount)); } while (0); return (unsigned int)NetworkAdapterCount; } /** * API does NOT verify that whether the interface name set as the * bridged or host-only interface of a NIC is valid. Warn the user if * IHost doesn't seem to know about it (non-fatal). */ void verifyHostNetworkInterfaceName(const ComPtr &pVirtualBox, const char *pszTargetName, HostNetworkInterfaceType_T enmTargetType) { HRESULT hrc; AssertReturnVoid( enmTargetType == HostNetworkInterfaceType_Bridged || enmTargetType == HostNetworkInterfaceType_HostOnly); ComPtr host; hrc = pVirtualBox->COMGETTER(Host)(host.asOutParam()); if (FAILED(hrc)) return; SafeIfaceArray ifs; hrc = host->COMGETTER(NetworkInterfaces)(ComSafeArrayAsOutParam(ifs)); if (FAILED(hrc)) return; for (size_t i = 0; i < ifs.size(); ++i) { const ComPtr iface = ifs[i]; Bstr bstrName; hrc = iface->COMGETTER(Name)(bstrName.asOutParam()); if (FAILED(hrc)) return; if (!bstrName.equals(pszTargetName)) continue; /* we found the interface but is it the right type? */ HostNetworkInterfaceType_T enmType; hrc = iface->COMGETTER(InterfaceType)(&enmType); if (FAILED(hrc)) return; if (enmType == enmTargetType) return; /* seems ok */ const char *pszTypeName; char a_szUnknownTypeBuf[32]; switch (enmType) { case HostNetworkInterfaceType_Bridged: pszTypeName = "type bridged"; break; case HostNetworkInterfaceType_HostOnly: pszTypeName = "type host-only"; break; default: RTStrPrintf(a_szUnknownTypeBuf, sizeof(a_szUnknownTypeBuf), "unknown type %RU32", enmType); pszTypeName = a_szUnknownTypeBuf; break; } RTMsgWarning("Interface \"%s\" is of %s", pszTargetName, pszTypeName); return; } RTMsgWarning("Interface \"%s\" doesn't seem to exist", pszTargetName); } #endif /* !VBOX_ONLY_DOCS */