[New - Windows NT]
The SECURITY_MESSAGE structure is used with the RasSecurityDialogComplete function to indicate the results of a RAS security DLL authentication transaction.
typedef struct _SECURITY_MESSAGE {
DWORD dwMsgId;
HPORT hPort;
DWORD dwError;
CHAR UserName[UNLEN+1];
CHAR Domain[DNLEN+1];
} SECURITY_MESSAGE, *PSECURITY_MESSAGE;
Members
dwMsgId
Indicates whether the RAS server should grant access to the remote user. This member can be one of the following values.
| Value | Meaning |
| SECURITYMSG_SUCCESS | The security DLL successfully authenticated the remote user identified by the UserName member. The RAS server will proceed with its PPP authentication. |
| SECURITYMSG_FAILURE | The security DLL denied access to the remote user identified by the UserName member. The RAS server will hang up the call and record the failed authentication in the Windows NT event log. |
| SECURITYMSG_ERROR | An error occurred that prevented validation of the remote user. The RAS server will hang up the call and record the error in the Windows NT event log. |
hPort
Specifies the port handle that the RAS server passed to the security DLL in the RasSecurityDialogBegin call for this authentication transaction.
dwError
Specifies an error code. If dwMsgId is SECURITYMSG_ERROR, set dwError to one of the nonzero error codes defined in WINERROR.H or RASERROR.H. The RAS server records this error code in the Windows NT event log. If the dwMsgId member indicates success or failure, set dwError to zero.
UserName
Specifies the name of the remote user if dwMsgId is SECURITYMSG_SUCCESS or SECURITYMSG_FAILURE. This string can be empty if dwMsgId is SECURITYMSG_ERROR.
Domain
Specifies the name of the logon domain for the remote user if dwMsgId is SECURITYMSG_SUCCESS or SECURITYMSG_FAILURE. This string can be empty if dwMsgId is SECURITYMSG_ERROR.
See Also