Функция 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.
| Код ошибки | Значение |
|---|---|
|
Один из параметров был недопустимым. Эта ошибка возвращается, если параметр 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 |