Функция ConvertInterfaceIndexToLuid (netioapi.h)
Функция ConvertInterfaceIndexToLuid преобразует локальный индекс для сетевого интерфейса в локальный уникальный идентификатор (LUID) для интерфейса.
Синтаксис
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceIndexToLuid(
[in] NET_IFINDEX InterfaceIndex,
[out] PNET_LUID InterfaceLuid
);
Параметры
[in] InterfaceIndex
Значение локального индекса для сетевого интерфейса.
[out] InterfaceLuid
Указатель на NET_LUID для этого интерфейса.
Возвращаемое значение
При успешном выполнении функция ConvertInterfaceIndexToLuid возвращает NO_ERROR. Любое ненулевое возвращаемое значение указывает на сбой, а в параметре InterfaceLuid возвращается значение NULL.
| Код ошибки | Значение |
|---|---|
|
Системе не удается найти указанный файл. Эта ошибка возвращается, если сетевой интерфейс, указанный параметром InterfaceIndex , не был значением на локальном компьютере. |
|
Один из параметров был недопустимым. Эта ошибка возвращается, если параметр InterfaceLuid имеет значение NULL или если параметр InterfaceIndex был недопустимым. |
Комментарии
Функция ConvertInterfaceIndexToLuid доступна в Windows Vista и более поздних версиях.
Функция ConvertInterfaceIndexToLuid не зависит от протокола и работает с сетевыми интерфейсами для протоколов IPv6 и IPv4.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | netioapi.h (включая Iphlpapi.h) |
| Библиотека | Iphlpapi.lib |
| DLL | Iphlpapi.dll |