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) 概述