/* $Id: VBoxManageUtils.cpp 94234 2022-03-15 09:19:29Z vboxsync $ */ /** @file * VBoxManageUtils.h - VBoxManage utility functions. */ /* * Copyright (C) 2006-2022 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. */ #include "VBoxManageUtils.h" #include "VBoxManage.h" #include #include #include #include #include using namespace com; DECLARE_TRANSLATION_CONTEXT(Utils); 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 = Utils::tr("type bridged"); break; case HostNetworkInterfaceType_HostOnly: pszTypeName = Utils::tr("type host-only"); break; default: RTStrPrintf(a_szUnknownTypeBuf, sizeof(a_szUnknownTypeBuf), Utils::tr("unknown type %RU32"), enmType); pszTypeName = a_szUnknownTypeBuf; break; } RTMsgWarning(Utils::tr("Interface \"%s\" is of %s"), pszTargetName, pszTypeName); return; } RTMsgWarning(Utils::tr("Interface \"%s\" doesn't seem to exist"), pszTargetName); }