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

Статья
08/25/2023

Функция 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 был недопустимым.

Требования

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