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

Функция RasSecurityDialogBegin (rasshost.h)

  • Статья

Функция RasSecurityDialogBegin — это сторонняя точка входа в библиотеку DLL безопасности RAS, которую сервер RAS вызывает, когда удаленный пользователь пытается подключиться. Это позволяет библиотеке DLL безопасности начать проверку подлинности удаленного пользователя.

Примечание Windows Server 2008, Windows Server 2003, Windows 2000 Server и Windows NT Server 4.0 в настоящее время обеспечивают поддержку узла безопасности RAS только для последовательных устройств. Другие типы подключений, такие как подключения к цифровой сети интегрированных служб (ISDN) или vpn-подключения, не поддерживаются.
 

Синтаксис

DWORD RasSecurityDialogBegin(
  [in] HPORT                        hPort,
  [in] PBYTE                        pSendBuf,
  [in] DWORD                        SendBufSize,
  [in] PBYTE                        pRecvBuf,
  [in] DWORD                        RecvBufSize,
       VOID(* )(SECURITY_MESSAGE *) RasSecurityDialogComplete
);

Параметры

[in] hPort

Указывает дескриптор порта RAS. Библиотека DLL безопасности использует этот дескриптор в других функциях безопасности RAS, таких как RasSecurityDialogSend и RasSecurityDialogReceive, для идентификации этой транзакции проверки подлинности.

Обратите внимание, что этот дескриптор действителен только в функциях безопасности RAS; не использовать его в других функциях ввода-вывода.

[in] pSendBuf

Указатель на буфер, выделенный сервером RAS. Библиотека DLL безопасности использует этот буфер с функцией RasSecurityDialogSend для отправки текста, отображаемого в окне терминала RAS на удаленном компьютере.

[in] SendBufSize

Задает размер буфера pSendBuf в байтах.

[in] pRecvBuf

Указатель на буфер, выделенный сервером RAS. Библиотека DLL безопасности использует этот буфер с функцией RasSecurityDialogReceive для получения ответа от удаленного пользователя.

[in] RecvBufSize

Задает размер буфера pRecvBuf в байтах.

RasSecurityDialogComplete

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

Если библиотека DLL безопасности успешно запускает операцию проверки подлинности, RasSecurityDialogBegin должен вернуть NO_ERROR. В этом случае библиотека DLL безопасности должна позже завершить транзакцию проверки подлинности, вызвав функцию, на которую указывает параметр RasSecurityDialogComplete .

При возникновении ошибки RasSecurityDialogBegin должен возвращать ненулевой код ошибки. В этом случае сервер RAS зависает вызов и записывает ошибку в журнал событий. Возврат ненулевого кода ошибки завершает транзакцию проверки подлинности, поэтому библиотеке DLL безопасности не нужно вызывать функцию RasSecurityDialogComplete .

Комментарии

Когда сервер RAS получает вызов с удаленного компьютера, он вызывает функцию RasSecurityDialogBegin , экспортированную зарегистрированной библиотекой безопасности RAS, если она есть. Когда сервер RAS вызывает эту функцию, он передает следующие сведения в библиотеку БЕЗОПАСНОСТИ DLL:

  • Дескриптор порта для идентификации подключения
  • Указатели на буферы, используемые при взаимодействии с удаленным пользователем
  • Указатель на функцию RasSecurityDialogComplete , вызываемую после завершения проверки подлинности.
Указатели дескриптора порта и буфера действительны до вызова RasSecurityDialogComplete для завершения транзакции проверки подлинности.

Реализация RasSecurityDialogBegin должна вернуться как можно скорее, так как сервер RAS заблокирован и не может принимать другие вызовы до тех пор, пока RasSecurityDialogBegin не вернет. Функция RasSecurityDialogBegin должна скопировать входные параметры и создать поток для взаимодействия с удаленным пользователем и проверки подлинности.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header rasshost.h

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

Функции администрирования сервера RAS

RasSecurityDialogComplete

RasSecurityDialogReceive

RasSecurityDialogSend

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