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


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

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

Синтаксис

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

Параметры

[in] InterfaceLuid

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

[out] InterfaceGuid

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

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

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

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

Комментарии

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

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

Требования

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

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

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex