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


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

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

Синтаксис

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceNameToLuidW(
  [in]  const WCHAR *InterfaceName,
  [out] NET_LUID    *InterfaceLuid
);

Параметры

[in] InterfaceName

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

[out] InterfaceLuid

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

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

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

Код ошибки Значение
ERROR_INVALID_NAME
Недопустимое имя интерфейса. Эта ошибка возвращается, если параметр InterfaceName содержит недопустимое имя или длина параметра InterfaceName превышает максимально допустимую длину строки для этого параметра.
ERROR_INVALID_PARAMETER
Один из параметров был недопустимым. Эта ошибка возвращается, если параметр InterfaceLuid имеет значение NULL.

Комментарии

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

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

ConvertInterfaceNameToLuidA преобразует имя интерфейса ANSI в LUID.

Максимальная длина имени интерфейса, 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 , который автоматически включается в файл заголовка Iphlpapi.h . Файлы заголовков Ntddndis.h, Ifdef.h и Netioapi.h никогда не следует использовать напрямую.

Требования

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

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

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

NET_LUID

if_indextoname

if_nametoindex