|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
RasSecurityDialogBegin
[New - Windows NT]
The RasSecurityDialogBegin function is a third-party RAS security DLL entry point that the Windows NT RAS server calls when a remote user tries to connect. This enables the security DLL to begin its authentication of the remote user.
DWORD WINAPI RasSecurityDialogBegin(
HPORT hPort, // RAS handle to the port PBYTE pSendBuf, // pointer to buffer for sending data DWORD SendBufSize, // size, in bytes, of the send buffer PBYTE pRecvBuf, // pointer to buffer for receiving data DWORD RecvBufSize, // size, in bytes, of the receive buffer VOID (WINAPI * RasSecurityDialogComplete) // pointer to the completion function );
Parameters
hPort
Specifies a RAS port handle. The security DLL uses this handle in other RAS security functions, such as RasSecurityDialogSend and RasSecurityDialogReceive, to identify this authentication transaction. Note that this handle is valid only in RAS security functions; you cannot use it in other Win32 I/O functions.
pSendBuf
Pointer to a buffer allocated by the RAS server. The security DLL uses this buffer with the RasSecurityDialogSend function to send text that is displayed in the RAS terminal window on the remote computer.
SendBufSize
Specifies the size, in bytes, of the pSendBuf buffer.
pRecvBuf
Pointer to a buffer allocated by the RAS server. The security DLL uses this buffer with the RasSecurityDialogReceive function to receive the response from the remote user.
RecvBufSize
Specifies the size, in bytes, of the pRecvBuf buffer.
RasSecurityDialogComplete
Specifies a pointer to a RasSecurityDialogComplete function. When the security DLL has completed the authentication of the remote user, it calls this function to report the results to the RAS server.
Return Values
If the security DLL successfully starts the authentication operation, RasSecurityDialogBegin should return NO_ERROR. In this case, the security DLL must later terminate the authentication transaction by calling the function pointed to by the RasSecurityDialogComplete parameter. If an error occurs, RasSecurityDialogBegin should return a nonzero error code. In this case, the RAS server hangs up the call and records the error in the Windows NT event log. Returning a nonzero error code terminates the authentication transaction, so the security DLL does not need to call the RasSecurityDialogComplete function.
Remarks
When a Windows NT RAS server receives a call from a remote computer, it calls the RasSecurityDialogBegin function exported by the registered RAS security DLL, if there is one. When the RAS server calls this function, it passes the following information to the security DLL:
· A port handle to identify the connection · Pointers to buffers to use when communicating with the remote user · A pointer to a RasSecurityDialogComplete function to call when the authentication has been completed
The port handle and buffer pointers are valid until you call RasSecurityDialogComplete to terminate the authentication transaction. Your RasSecurityDialogBegin implementation must return as soon as possible, because the RAS server is blocked and cannot accept any other calls until RasSecurityDialogBegin returns. The RasSecurityDialogBegin function should copy the input parameters and create a thread to communicate with and authenticate the remote user.
See Also
RasSecurityDialogComplete, RasSecurityDialogReceive, RasSecurityDialogSend
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
RasSecurityDialogBegin
[Новый - Windows NT]
Функция RasSecurityDialogBegin является независимым входом безопасности RAS точки DLL, что сервер Windows NT RAS называет когда дистанционный пользователь пытается соединяться. Это позволяет безопасность DLL, чтобы начинать свою аутентификацию дистанционного пользователя.
DWORD WINAPI RasSecurityDialogBegin(
HPORT hPort, // РУЧКА RAS в порт PBYTE pSendBuf, // указатель, чтобы буферизоваться для посылки данных DWORD SendBufSize, // размер, в байтах, посылает буфер PBYTE pRecvBuf, // указатель, чтобы буферизоваться чтобы получать данные DWORD RecvBufSize, // размер, в байтах, буферной ПУСТОТЫ приемника (WINAPI * RasSecurityDialogComplete) // указатель в функцию завершения );
Параметры
hPort
Определяет ручку порта RAS. Безопасность DLL использует эту ручку в других функциях безопасности RAS, как например, RasSecurityDialogSend и RasSecurityDialogReceive, чтобы идентифицировать эту сделку аутентификации. Отметьте, что эта ручка - в силе только в функциях безопасности RAS; Вы не можете использовать это в других функциях Win32 В/В.
pSendBuf
Указатель в буфер распределялся сервером RAS. Безопасность DLL использует этот буфер с функцией RasSecurityDialogSend, чтобы посылать текст, который отображен в терминальном окне RAS в дистанционном компьютере.
SendBufSize
Определяет размер, в байтах, буфера pSendBuf.
pRecvBuf
Указатель в буфер распределялся сервером RAS. Безопасность DLL использует этот буфер с функцией RasSecurityDialogReceive, чтобы получать ответ из дистанционного пользователя.
RecvBufSize
Определяет размер, в байтах, буфера pRecvBuf.
RasSecurityDialogComplete
Определяет указатель в функцию RasSecurityDialogComplete. Когда безопасность DLL завершила аутентификацию дистанционного пользователя, она называет эту функцию, чтобы сообщать результаты в сервер RAS.
Обратные Величины
Если безопасность DLL успешно начинает операцию аутентификации, RasSecurityDialogBegin должен возвращать NO_ERROR. В этом случае, безопасность DLL должна позже завершить сделку аутентификации вызывая функцию указывался, чтобы параметром RasSecurityDialogComplete. Если ошибка происходит, RasSecurityDialogBegin должен возвращать ненулевой код ошибки. В этом случае, сервер RAS отключает вызов и записывает ошибку в протокол события Windows NT. Возврат ненулевого кода ошибки завершает сделку аутентификации, так что безопасности DLL не нужно называть функцию RasSecurityDialogComplete.
Замечания
Когда сервер Windows NT RAS получает вызов из дистанционного компьютера, он называет функцию RasSecurityDialogBegin экспортированную зарегистрированной безопасностью RAS DLL, если есть один. Когда сервер RAS называет эту функцию, он передает следующую информацию в безопасность DLL:
Ручка порта, чтобы идентифицировать связь Указатели в буферы, чтобы использоваться передаваясь с дистанционным пользователем указатель в функцию RasSecurityDialogComplete, чтобы называться когда аутентификация завершена
Ручка порта и буферных указателей будут в силе пока Вы не назовете RasSecurityDialogComplete, чтобы завершать сделку аутентификации. Ваша реализация RasSecurityDialogBegin должна возвращать как можно скорее, поскольку сервер RAS заблокирован и не может принять любые другие вызовы до возврат RasSecurityDialogBegin. Функция RasSecurityDialogBegin должна копировать входные параметры и создавать резьбу, чтобы связываться с и удостоверять дистанционного пользователя.
Смотри Также
RasSecurityDialogComplete, RasSecurityDialogReceive, RasSecurityDialogSend
|
|
|
|
| |