Share via

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

  • Статья

Функция RasGetProjectionInfoEx получает сведения об операциях удаленного доступа PPP или IKEv2 для всех подключений RAS на локальном клиенте.

Синтаксис

DWORD RasGetProjectionInfoEx(
  [in]      HRASCONN             hrasconn,
  [in, out] PRAS_PROJECTION_INFO pRasProjection,
  [in, out] LPDWORD              lpdwSize
);

Параметры

[in] hrasconn

Дескриптор подключения RAS, для которого необходимо изменить конечные точки туннеля. Это может быть дескриптор, возвращаемый функцией RasDial или RasEnumConnections .

[in, out] pRasProjection

Указатель на структуру RAS_PROJECTION_INFO , которая получает сведения о проекции для подключений RAS.

[in, out] lpdwSize

Указатель во входных данных, указывающий размер (в байтах) буфера, на который указывает pRasProjection. В выходных данных эта переменная получает размер буфера в байтах, необходимый для хранения количества RAS_PROJECTION_INFO структур, на которые указывает pRasProjection.

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

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

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

Значение Значение
ERROR_BUFFER_TOO_SMALL
 Буфер, на который указывает pRasProjection , недостаточно велик, чтобы содержать запрошенные сведения.
ERROR_INVALID_HANDLE
 Параметр hrasconn не является допустимым дескриптором.
ERROR_INVALID_PARAMETER
 Функция была вызвана с недопустимым параметром.
ERROR_INVALID_SIZE
 Элемент dwSize структуры, на который указывает pRasProjection , указывает недопустимый размер.
ERROR_PROTOCOL_NOT_CONFIGURED
 Протокол управления, для которого запрашивалась информация, не был выполнен ни успешно, ни не завершился ошибкой, так как запись телефонной книги подключения не требует, чтобы была предпринята попытка согласования протокола.

Комментарии

Проекция удаленного доступа — это процесс, в котором сервер удаленного доступа и удаленный клиент согласовывают сведения, относящиеся к сетевому протоколу. Сервер удаленного доступа использует эти сведения, относящиеся к сетевому протоколу, для представления удаленного клиента в сети.

Сведения о проекции удаленного доступа недоступны, пока операционная система не запустит состояние RASCS_Projected на подключении удаленного доступа. Если метод RasGetProjectionInfoEx вызывается до RASCS_Projected состояния, он возвращает ERROR_PROJECTION_NOT_COMPLETE.

Требования

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

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

Общие сведения о службе удаленного доступа (RAS)

Функции службы удаленного доступа