Функция ConvertInterfaceAliasToLuid
Функция ConvertInterfaceAliasToLuid преобразует имя псевдонима интерфейса для сетевого интерфейса в локально уникальный идентификатор (LUID) для интерфейса.
Примечание
Семейство API ConvertInterfaceXxx перечисляет идентификаторы по всем интерфейсам, привязанным к TCP/IP, которые могут включать виртуальные минипорты, упрощенные фильтры, адаптеры туннеля и физические интерфейсы.
Синтаксис
NETIOAPI_API ConvertInterfaceAliasToLuid(
_In_ const WCHAR *InterfaceAlias,
_Out_ PNET_LUID InterfaceLuid
);
Параметры
InterfaceAlias [in]
Указатель на строку Юникода, завершающуюся значением NULL, которая содержит псевдоним сетевого интерфейса.InterfaceLuid [out]
Указатель на NET_LUID объединение для сетевого интерфейса.
Возвращаемое значение
Функция ConvertInterfaceAliasToLuid возвращает STATUS_SUCCESS, если функция выполнена успешно. Если функция завершается сбоем, параметру InterfaceLuid присваивается значение NULL, а ConvertInterfaceAliasToLuid возвращает следующий код ошибки:
| Код возврата | Описание |
|---|---|
| STATUS_INVALID_PARAMETER | Один из параметров был недопустимым. ConvertInterfaceAliasToLuid возвращает эту ошибку , если interfaceAlias или InterfaceLuid имеет значение NULL или если InterfaceAlias недопустим. |
Комментарии
Функция ConvertInterfaceAliasToLuid не зависит от протокола и работает с сетевыми интерфейсами для протоколов IPv6 и IPv4.
Требования
Целевая платформа |
Универсальное |
Версия |
Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
Заголовок |
Netioapi.h (включая Netioapi.h) |
Библиотека |
Netio.lib |
IRQL |
PASSIVE_LEVEL |