Edit

SECURITY_MESSAGE structure (rasshost.h)

  • Article

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