На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

RasSecurityDialogReceive



[New - Windows NT]

The RasSecurityDialogReceive function starts an asynchronous operation that receives a response from a remote user. The response is the input that the user typed in a terminal window on the remote computer. A third-party RAS security DLL calls this function as part of its authentication of the remote user.
To call this function, you must first call the LoadLibrary function to load RASMAN.DLL. Then call the GetProcAddress function to get the DLL's RasSecurityDialogReceive entry point.

DWORD WINAPI RasSecurityDialogReceive(

HPORT hPort, // RAS handle to the port
PBYTE pBuffer, // pointer to buffer that receives the user's response
PWORD pBufferLength, // returns size, in bytes, of the data received
DWORD Timeout, // time-out period, in seconds
HANDLE hEvent // event that is signaled when operation is finished
);


Parameters

hPort

Specifies the port handle that the RAS server passed to the security DLL in the RasSecurityDialogBegin call for this authentication transaction.

pBuffer

Pointer to the receive buffer that was passed to the security DLL in the RasSecurityDialogBegin call. When the asynchronous receive operation has been completed successfully, this buffer contains the response from the remote user.

pBufferLength

Pointer to a variable that receives the number of bytes returned in the pBuffer buffer.

Timeout

Specifies a time-out period, in seconds, after which the RAS server sets the hEvent event object to the signaled state. If this value is zero, there is no time-out period; that is, the RAS server does not signal the event object until the receive operation has been completed.

hEvent

Specifies the handle of an event object created by the CreateEvent function. The RAS server sets the event object to the signaled state when the receive operation has been completed or when the time-out period has elapsed.



Return Values

If the function is successful, the return value is PENDING (defined in RASERROR.H). This indicates that the receive operation is in progress.
If an error occurs, the return value is one of the error codes defined in RASERROR.H or WINERROR.H. GetLastError does not provide extended error information.

Remarks

After calling the RasSecurityDialogSend function to send a security challenge to the remote user, the security DLL must call the RasSecurityDialogReceive function to get the user's response.
The RasSecurityDialogReceive function is asynchronous. When the function returns, the security DLL must use one of the wait functions, such as WaitForSingleObject, to wait for the hEvent event object to be signaled. The RAS server signals the event object when the receive operation has been completed or when the time-out interval has elapsed. If the receive operation is successful, the pBuffer buffer contains the response from the remote user, and the pBufferLength parameter indicates the number of bytes received.

You can use the Timeout parameter to specify a time-out interval. If the time-out elapses, the RAS server signals the event object, and the pBufferLength parameter indicates that zero bytes were transferred. Alternatively, you can set Timeout to zero, and specify a time-out interval in the wait function that you use to wait for the event object to be signaled.
When a security DLL is authenticating a remote user, the connection operation on the remote computer enters a RASCS_Interactive paused state. The message sent by RasSecurityDialogSend is displayed as output in a terminal window on the remote computer. The response received by RasSecurityDialogReceive is the input that the remote user types in the terminal window. The RASCS_Interactive value is defined in the RASCONNSTATE enumeration.

See Also

CreateEvent, GetProcAddress, LoadLibrary, RASCONNSTATE, RasSecurityDialogSend, WaitForSingleObject


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

RasSecurityDialogReceive



[Новый - Windows NT]

Функция RasSecurityDialogReceive начинает асинхронное действие, которое получает ответ из дистанционного потребителя. Ответ является вкладом, что потребитель заносил терминальное окно в дистанционный компьютер. Независимая безопасность RAS DLL называет эту функцию как часть своей аутентификации дистанционного потребителя.
Чтобы называть эту функцию, Вы должны сначала назвать функцию LoadLibrary, чтобы загружать RASMAN.DLL. Затем назовите функцию GetProcAddress, чтобы получать точку входа DLL's RasSecurityDialogReceive.

DWORD WINAPI RasSecurityDialogReceive(

HPORT hPort, // РУЧКА RAS в порт PBYTE pBuffer, // указатель, чтобы буферизовать, что получает ответ пользователя PWORD pBufferLength, // размер возврата, в байтах, данных получивших Тайм-аут DWORD, // период задержки, в течение РУЧКИ секунд hEvent // событие, который сигнализирован когда операция завершена
);


Параметры

hPort

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

pBuffer

Указатель в буфер приемника, который был пройден в безопасность DLL на вызове RasSecurityDialogBegin. Когда асинхронная операция приемника завершается успешно, этот буфер содержит ответ из дистанционного пользователя.

pBufferLength

Указатель в переменную, которая получает количество байтов возвращался в буфер pBuffer.

Тайм-аут

Определяет период задержки, в течение секунд, после которого сервер RAS устанавливает объект события hEvent против сигнального состояния. Если эта величина - нуль, нет периода задержки; то есть, сервер RAS не сигнализирует объект события пока операция приемника не завершена.

hEvent

Определяет ручку объекта события созданного функцией CreateEvent. Сервер RAS устанавливает объект события против сигнального состояния когда операция приемника завершена или когда период задержки прошел.



Обратные Величины

Если функция имеет успех, обратная величина РАССМАТРИВАЕТ (определенное в RASERROR.H). Это указывает, что операция приемника осуществляется.
Если ошибка происходит, обратная величина - одного из кодов ошибки определенных в RASERROR.H или WINERROR.H. GetLastError НЕ обеспечивает расширенную информацию ошибки.

Замечания

После вызова функции RasSecurityDialogSend, чтобы посылать безопасности вызов дистанционному пользователю, безопасность DLL должна назвать функцию RasSecurityDialogReceive, чтобы получать ответ пользователя.
Функция RasSecurityDialogReceive асинхронная. Когда функция возвращается, безопасность DLL должна использовать одну из функций ожидания, как например, WaitForSingleObject, чтобы ждать объект события hEvent против сигнализирован. Сервер RAS сигнализирует объект события когда операция приемника завершена или когда интервал задержки прошел. Если операция приемника имеет успех, буфер pBuffer содержит ответ из дистанционного пользователя, и параметр pBufferLength указывает количество полученных байтов.

Вы можете использовать параметр Тайм-аута, чтобы определять интервал задержки. Если задержка истекает, сервер RAS сигнализирует объект события, и параметр pBufferLength указывает, что нулевые байты были переданы. Кроме того, Вы можете установить Тайм-аут в нуль и определять интервал задержки в функции ожидания, что Вы используете, чтобы ждать объект события против сигнализирован.
Когда безопасность DLL удостоверяет дистанционного пользователя, операция связи на дистанционных компьютерных вводах RASCS_Interactive остановившееся состояние. Сообщение посланное RasSecurityDialogSend отображено как выход в терминальном окне в дистанционном компьютере. Ответ полученный RasSecurityDialogReceive - ввод, что дистанционный пользователь заносит терминальное окно. Величина RASCS_Interactive определена в перечислении RASCONNSTATE.

Смотри Также

CreateEvent, GetProcAddress, LoadLibrary, RASCONNSTATE, RasSecurityDialogSend, WaitForSingleObject


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz