Функция 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.
| Код ошибки | Значение |
|---|---|
|
Один из параметров был недопустимым. Эта ошибка возвращается, если параметр 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 |