MSV1_0_SUBAUTH_LOGON structure
The MSV1_0_SUBAUTH_LOGON structure is used by subauthentication DLLs.
Syntax
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;
Members
- MessageType
-
A MSV1_0_LOGON_SUBMIT_TYPE value that indicates the type of logon being requested. This value must be set to MsV1_0SubAuthLogon.
- LogonDomainName
-
A UNICODE_STRING that contains the name of the logon domain. The specified domain name must be a Windows domain or a mixed domain that is trusted by this computer. If the logon domain name is not known (for example, for clients that do not supply this information), this member should be passed in as a zero-length string. This is the authenticating authority.
- UserName
-
A UNICODE_STRING that contains the account name of the user. The name can be up to 255 bytes long. The name is treated as case insensitive.
- Workstation
-
A UNICODE_STRING that contains the computer name of the workstation where the user logon request was initiated.
- ChallengeToClient
-
Contains the challenge returned from a previous call to LsaCallAuthenticationPackage, when MsV1_0Lm20ChallengeRequest was specified as the message type. For more information, see the description of MsV1_0Lm20ChallengeRequest in MSV1_0_PROTOCOL_MESSAGE_TYPE. This enables the authentication package to determine whether the challenge response is correct.
- AuthenticationInfo1
-
Contains subauthentication package–specific information. For more information, see the subauthentication package documentation.
- AuthenticationInfo2
-
Contains subauthentication package specific information. For more information, see the subauthentication package documentation.
- ParameterControl
-
Specifies additional information about how the logon should be processed. This member can contain one or more of the following values.
Value Meaning - MSV1_0_CLEARTEXT_PASSWORD_ALLOWED
LanMan2.0 or LanMan1.0 send a plaintext password instead of a challenge response. To allow plaintext passwords to be used in the NetworkLogon message, an application must supply this flag.
- MSV1_0_UPDATE_LOGON_STATISTICS
Update the logon statistics for the account. If this flag is not set, the bad password count is set to zero upon successful logon.
- MSV1_0_RETURN_USER_PARAMETERS
Causes the user parameters to be returned in the HomeDirectoryDrive member of the MSV1_0_INTERACTIVE_PROFILE structure.
- MSV1_0_DONT_TRY_GUEST_ACCOUNT
Prevents the user from logging on with a guest account.
- MSV1_0_ALLOW_SERVER_TRUST_ACCOUNT
If this flag is set, domain controller accounts can be used for authentication; otherwise, only user accounts can be used.
- MSV1_0_RETURN_PASSWORD_EXPIRY
Causes the password expiration time to be returned in the LogoffTime member of the MSV1_0_LM20_LOGON_PROFILE structure returned in the output buffer.
- MSV1_0_ALLOW_WORKSTATION_TRUST_ACCOUNT
Permits remote-boot clients to log on using a computer account.
- MSV1_0_TRY_GUEST_ACCOUNT_ONLY
Causes the user to log on using the guest account.
- MSV1_0_RETURN_PROFILE_PATH
Returns the profile path associated with the logged on user.
- MSV1_0_TRY_SPECIFIED_DOMAIN_ONLY
Only a domain controller associated with the specified domain will attempt to validate the logon request.
- SubAuthPackageId
-
Contains the subauthentication package identifier. This value is set by the subauthentication package vendor.
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
See also
- LsaCallAuthenticationPackage
- MSV1_0_INTERACTIVE_PROFILE
- MSV1_0_LM20_LOGON_PROFILE
- MSV1_0_LOGON_SUBMIT_TYPE
- MSV1_0_PROTOCOL_MESSAGE_TYPE