Поделиться через


Функция ConvertInterfaceAliasToLuid (netioapi.h)

Функция ConvertInterfaceAliasToLuid преобразует имя псевдонима интерфейса для сетевого интерфейса в локально уникальный идентификатор (LUID) для интерфейса.

Синтаксис

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceAliasToLuid(
  [in]  const WCHAR *InterfaceAlias,
  [out] PNET_LUID   InterfaceLuid
);

Параметры

[in] InterfaceAlias

Указатель на строку Юникода с завершением NULL, содержащую псевдоним сетевого интерфейса.

[out] InterfaceLuid

Указатель на NET_LUID для этого интерфейса.

Возвращаемое значение

При успешном выполнении функция ConvertInterfaceAliasToLuid возвращает NO_ERROR. Любое ненулевое возвращаемое значение указывает на сбой, а в параметре InterfaceLuid возвращается значение NULL.

Код ошибки Значение
ERROR_INVALID_PARAMETER
Один из параметров был недопустимым. Эта ошибка возвращается, если параметр InterfaceAlias или InterfaceLuid имеет значение NULL или если параметр InterfaceAlias был недопустимым.

Комментарии

Функция ConvertInterfaceAliasToLuid доступна в Windows Vista и более поздних версиях.

Функция ConvertInterfaceAliasToLuid не зависит от протокола и работает с сетевыми интерфейсами для протокола IPv6 и IPv4.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header netioapi.h (включая Iphlpapi.h)
Библиотека Iphlpapi.lib
DLL Iphlpapi.dll

См. также раздел

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex