SECURITY_MESSAGE 结构 (rasshost.h)

SECURITY_MESSAGE 结构与 RasSecurityDialogComplete 函数一起使用,以指示 RAS 安全 DLL 身份验证事务的结果。

语法

typedef struct _SECURITY_MESSAGE {
  DWORD dwMsgId;
  HPORT hPort;
  DWORD dwError;
  CHAR  UserName[UNLEN + 1];
  CHAR  Domain[DNLEN + 1];
} SECURITY_MESSAGE, *PSECURITY_MESSAGE;

成员

dwMsgId

指示 RAS 服务器是否应向远程用户授予访问权限。 此成员可以是以下值之一。

含义
SECURITYMSG_SUCCESS
安全 DLL 已成功对 UserName 成员标识的远程用户进行身份验证。 RAS 服务器继续执行其 PPP 身份验证。
SECURITYMSG_FAILURE
安全 DLL 拒绝访问 由 UserName 成员标识的远程用户。 RAS 服务器挂起呼叫,并将失败的身份验证记录在事件日志中。
SECURITYMSG_ERROR
发生错误,导致远程用户无法验证。 RAS 服务器挂起呼叫,并在事件日志中记录错误。

hPort

指定 RAS 服务器为此身份验证事务在 RasSecurityDialogBegin 调用中传递给安全 DLL 的端口句柄。

dwError

指定一个错误代码。 如果 dwMsgId 是SECURITYMSG_ERROR,请将 dwError 设置为 Winerror.h 或 Raserror.h 中定义的非零错误代码之一。 RAS 服务器将此错误代码记录在事件日志中。 如果 dwMsgId 成员指示成功或失败,请将 dwError 设置为零。

UserName[UNLEN + 1]

指定SECURITYMSG_SUCCESS或SECURITYMSG_FAILURE dwMsgId 时远程用户的名称。 如果 SECURITYMSG_ERROR dwMsgId ,则此字符串可以为空。

Domain[DNLEN + 1]

指定远程用户的登录域名称(如果 dwMsgId 是SECURITYMSG_SUCCESS或SECURITYMSG_FAILURE)。 如果 SECURITYMSG_ERROR dwMsgId ,则此字符串可以为空。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 rasshost.h

另请参阅

RAS 服务器管理结构

RasSecurityDialogBegin

RasSecurityDialogComplete

远程访问服务 (RAS) 概述