SECURITY_MESSAGE structure (rasshost.h)

The SECURITY_MESSAGE structure is used with the RasSecurityDialogComplete function to indicate the results of a RAS security DLL authentication transaction.

Syntax

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 proceeds with its PPP authentication.
SECURITYMSG_FAILURE	The security DLL denied access to the remote user identified by the UserName member. The RAS server hangs up the call and records the failed authentication in the event log.
SECURITYMSG_ERROR	An error occurred that prevented validation of the remote user. The RAS server hangs up the call and records the error in the 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 event log. If the dwMsgId member indicates success or failure, set dwError to zero.

UserName[UNLEN + 1]

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[DNLEN + 1]

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

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	rasshost.h

See also

RAS Server Administration Structures

RasSecurityDialogBegin

RasSecurityDialogComplete

Remote Access Service (RAS) Overview