When a Windows NT/Windows 2000 RAS server receives a call, it invokes the RasSecurityDialogBegin function of the registered RAS security DLL, if there is one. This call notifies the security DLL to begin its authentication of the remote user. The RAS server calls RasSecurityDialogBegin before performing its PPP or RAS authentication.
The RasSecurityDialogBegin call 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 the security DLL calls RasSecurityDialogComplete to terminate the authentication transaction.
The RasSecurityDialogComplete notifies the RAS server of the results of the security DLL's authentication of the remote user. If the security DLL reports success, the RAS server proceeds with its PPP and RAS authentication of the remote user. If the security DLL reports that the remote user failed the authentication, or that an error occurred, the RAS server hangs up and logs the error or failed authentication in the event log.
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
