Edit

Share via

SEC_WINNT_AUTH_IDENTITY_EXA structure (sspi.h)

  • Article

The SEC_WINNT_AUTH_IDENTITY_EX structure contains information about a user. Both an ANSI and Unicode form of this structure are provided.

Syntax

typedef struct _SEC_WINNT_AUTH_IDENTITY_EXA {
  unsigned long Version;
  unsigned long Length;
  unsigned char *User;
  unsigned long UserLength;
  unsigned char *Domain;
  unsigned long DomainLength;
  unsigned char *Password;
  unsigned long PasswordLength;
  unsigned long Flags;
  unsigned char *PackageList;
  unsigned long PackageListLength;
} SEC_WINNT_AUTH_IDENTITY_EXA, *PSEC_WINNT_AUTH_IDENTITY_EXA;

Members

Version

An unsigned long that indicates the version number of the structure.

Length

An unsigned long that indicates the length, in bytes, of the structure.

User

A Unicode or ANSI string that contains the name of the user account.

UserLength

The length, in characters, of the User string.

Domain

A Unicode or ANSI string that contains the name of the domain for the user account.

DomainLength

The length, in characters, of the Domain string.

Password

A Unicode or ANSI string that contains the user password in plaintext. When you have finished using the password, remove the sensitive information from memory by calling the SecureZeroMemory function. For more information about protecting the password, see Handling Passwords.

PasswordLength

The length, in characters, of the Password string.

Flags

An unsigned long flag that indicates the type used by negotiable security packages.

Value Meaning
SEC_WINNT_AUTH_IDENTITY_MARSHALLED
 All data is in one buffer.
SEC_WINNT_AUTH_IDENTITY_ONLY
 Used with the Kerberos security support provider (SSP). Credentials are for identity only. The Kerberos package is directed to not include authorization data in the ticket.
SEC_WINNT_AUTH_IDENTITY_ANSI
 Credentials are in ANSI form.
SEC_WINNT_AUTH_IDENTITY_UNICODE
 Credentials are in Unicode form.

PackageList

A Unicode or ANSI string that contains a comma-separated list of names of security packages that are available when using the Microsoft Negotiate provider.

Set this to "!ntlm" to specify that the NTLM package is not to be used.

PackageListLength

The length, in characters, of the PackageList string.

Remarks

Note that when this structure is used with RPC, the structure must remain valid for the lifetime of the binding handle.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header sspi.h