SECURITY_MESSAGE

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/2000 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/2000 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/Windows 2000 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.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Unsupported.
  Header: Declared in Rasshost.h.

See Also

Remote Access Service (RAS) Overview, RAS Server Administration Structures, RasSecurityDialogBegin, RasSecurityDialogComplete