MSV1_0_SUBAUTH_LOGON structure (ntsecapi.h)
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[MSV1_0_CHALLENGE_LENGTH]
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 |
|---|---|
|
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. |
|
Update the logon statistics for the account. If this flag is not set, the bad password count is set to zero upon successful logon. |
|
Causes the user parameters to be returned in the HomeDirectoryDrive member of the MSV1_0_INTERACTIVE_PROFILE structure. |
|
Prevents the user from logging on with a guest account. |
|
If this flag is set, domain controller accounts can be used for authentication; otherwise, only user accounts can be used. |
|
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. |
|
Permits remote-boot clients to log on using a computer account. |
|
Causes the user to log on using the guest account. |
|
Returns the profile path associated with the logged on user. |
|
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Header | ntsecapi.h |