MSV1_0_SUBAUTH_LOGON结构 (ntsecapi.h)

项目
08/25/2023

子身份验证 DLL 使用MSV1_0_SUBAUTH_LOGON结构。

语法

typedef struct _MSV1_0_SUBAUTH_LOGON {
  MSV1_0_LOGON_SUBMIT_TYPE MessageType;
  UNICODE_STRING           LogonDomainName;
  UNICODE_STRING           UserName;
  UNICODE_STRING           Workstation;
  UCHAR                    ChallengeToClient[MSV1_0_CHALLENGE_LENGTH];
  STRING                   AuthenticationInfo1;
  STRING                   AuthenticationInfo2;
  ULONG                    ParameterControl;
  ULONG                    SubAuthPackageId;
} MSV1_0_SUBAUTH_LOGON, *PMSV1_0_SUBAUTH_LOGON;

成员

MessageType

一个MSV1_0_LOGON_SUBMIT_TYPE值，该值指示所请求的登录类型。此值必须设置为 MsV1_0SubAuthLogon。

LogonDomainName

包含登录域名称的 UNICODE_STRING 。指定的域名必须是此计算机信任的 Windows 域或混合域。例如，如果登录域名 (未知，则对于未) 提供此信息的客户端，应将此成员作为零长度字符串传入。这是身份验证机构。

UserName

包含用户的帐户名的 UNICODE_STRING 。该名称的长度最多为 255 个字节。该名称被视为不区分大小写。

Workstation

包含发起用户登录请求的工作站的计算机名称的UNICODE_STRING 。

ChallengeToClient[MSV1_0_CHALLENGE_LENGTH]

包含上一次调用 LsaCallAuthenticationPackage 返回的质询， 当MsV1_0Lm20ChallengeRequest 指定为消息类型时。有关详细信息，请参阅 MSV1_0_PROTOCOL_MESSAGE_TYPE 中 MsV1_0Lm20ChallengeRequest的说明。这使身份验证包能够确定质询响应是否正确。

AuthenticationInfo1

包含特定于子身份验证包的信息。有关详细信息，请参阅子身份验证包文档。

AuthenticationInfo2

包含子身份验证包特定信息。有关详细信息，请参阅子身份验证包文档。

ParameterControl

指定有关如何处理登录的其他信息。此成员可以包含以下一个或多个值。

值	含义
MSV1_0_CLEARTEXT_PASSWORD_ALLOWED	LanMan2.0 或 LanMan1.0 发送纯文本密码，而不是质询响应。若要允许在 NetworkLogon 消息中使用纯文本密码，应用程序必须提供此标志。
MSV1_0_UPDATE_LOGON_STATISTICS	更新帐户的登录统计信息。如果未设置此标志，则成功登录后，错误的密码计数将设置为零。
MSV1_0_RETURN_USER_PARAMETERS	使用户参数在 MSV1_0_INTERACTIVE_PROFILE 结构的 HomeDirectoryDrive 成员中返回。
MSV1_0_DONT_TRY_GUEST_ACCOUNT	阻止用户使用来宾帐户登录。
MSV1_0_ALLOW_SERVER_TRUST_ACCOUNT	如果设置了此标志，则可以使用域控制器帐户进行身份验证;否则，只能使用用户帐户。
MSV1_0_RETURN_PASSWORD_EXPIRY	导致在输出缓冲区中返回的 MSV1_0_LM20_LOGON_PROFILE 结构的 LogoffTime 成员中返回密码过期时间。
MSV1_0_ALLOW_WORKSTATION_TRUST_ACCOUNT	允许远程启动客户端使用计算机帐户登录。
MSV1_0_TRY_GUEST_ACCOUNT_ONLY	使用户使用来宾帐户登录。
MSV1_0_RETURN_PROFILE_PATH	返回与登录用户关联的配置文件路径。
MSV1_0_TRY_SPECIFIED_DOMAIN_ONLY	只有与指定域关联的域控制器才会尝试验证登录请求。