Функция RasGetNapStatus (ras.h)

  • Статья

Функция RasGetNapStatus извлекает переменные состояния подключения защиты доступа к сети (NAP) для данного подключения удаленного доступа.

Синтаксис

DWORD RasGetNapStatus(
  [in]      HRASCONN      hRasconn,
  [in, out] LPRASNAPSTATE pRasNapState
);

Параметры

[in] hRasconn

Дескриптор соединения. Используйте RasDial или RasEnumConnections для получения этого дескриптора.

[in, out] pRasNapState

Указатель на структуру RASNAPSTATE . Во входных данных члену dwSize структуры необходимо задать значение sizeof(RASNAPSTATE). В выходных данных pNapState возвращает состояние NAP подключения RAS.

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

Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается ошибкой, возвращается один из следующих кодов ошибок или значение из кода ошибок маршрутизации и удаленного доступа или Winerror.h.

Код возврата Описание
ERROR_NOT_NAP_CAPABLE
 Подключение, соответствующее параметру hRasConn , не настроено для NAP.
ERROR_INVALID_SIZE
 Параметр dwSize структуры RASNAPSTATE имеет недопустимое значение размера.
ERROR_INVALID_HANDLE
 Дескриптор, передаваемый в функцию, имеет значение NULL или недопустимый.
ERROR_NO_CONNECTION
 RASMAN не удалось найти дескриптор в списке дескрипторов.

Требования

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