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

Статья
08/25/2023

Функция RasSecurityDialogSend отправляет сообщение для отображения в окне терминала на удаленном компьютере. Сторонняя библиотека безопасности RAS отправляет это сообщение в рамках проверки подлинности удаленного пользователя.

Чтобы вызвать эту функцию, сначала вызовите функцию LoadLibrary для загрузки Rasman.dll. Затем вызовите функцию GetProcAddress , чтобы получить точку входа RasSecurityDialogSend библиотеки DLL.

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

Синтаксис

DWORD RasSecurityDialogSend(
  [in] HPORT hPort,
  [in] PBYTE pBuffer,
  [in] WORD  BufferLength
);

Параметры

[in] hPort

Указывает дескриптор порта, переданный сервером RAS в библиотеку DLL безопасности в вызове RasSecurityDialogBegin для этой транзакции проверки подлинности.

[in] pBuffer

Указатель на буфер отправки, который был передан в библиотеку DLL безопасности в вызове RasSecurityDialogBegin. Перед вызовом RasSecurityDialogSend скопируйте в этот буфер сообщение для отправки удаленному пользователю. Параметр SendBufSize функции RasSecurityDialogBegin указывает максимальное количество байтов, которое может хранить буфер.

[in] BufferLength

Указывает количество байтов для отправки в буфере pBuffer .

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

При успешном выполнении функции возвращается значение PENDING (определенное в Файле Raserror.h). Это означает, что операция отправки выполняется.

При возникновении ошибки возвращаемое значение представляет собой один из кодов ошибок, определенных в Raserror.h или Winerror.h. GetLastError не предоставляет расширенные сведения об ошибке.

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

Когда библиотека DLL безопасности выполняет проверку подлинности удаленного пользователя, операция подключения на удаленном компьютере переходит в состояние RASCS_Interactive приостановлено. Сообщение, отправленное RasSecurityDialogSend , отображается в виде выходных данных в окне терминала на удаленном компьютере. Ответ, полученный RasSecurityDialogReceive , представляет собой входные данные, введенные удаленным пользователем в окне терминала. Значение RASCS_Interactive определяется в перечислении RASCONNSTATE .

Требования

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