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