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


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

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

Синтаксис

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceGuidToLuid(
  [in]  const GUID *InterfaceGuid,
  [out] PNET_LUID  InterfaceLuid
);

Параметры

[in] InterfaceGuid

Указатель на ИДЕНТИФИКАТОР GUID для сетевого интерфейса.

[out] InterfaceLuid

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

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

При успешном выполнении Функция ConvertInterfaceGuidToLuid возвращает NO_ERROR. Любое ненулевое возвращаемое значение указывает на сбой, а в параметре InterfaceLuid возвращается значение NULL.

Код ошибки Значение
ERROR_INVALID_PARAMETER
Один из параметров был недопустимым. Эта ошибка возвращается, если параметр InterfaceAlias или InterfaceLuid имеет значение NULL или если параметр InterfaceGuid был недопустимым.

Комментарии

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

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

Требования

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

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

ConvertInterfaceAliasToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex