SEC_WINNT_AUTH_IDENTITY_A structure (rpcdce.h)

The SEC_WINNT_AUTH_IDENTITY structure enables passing a particular user name and password to the run-time library for the purpose of authentication. The structure is valid for Windows and Macintosh.

Syntax

typedef struct _SEC_WINNT_AUTH_IDENTITY_A {
  unsigned char *User;
  unsigned long UserLength;
  unsigned char *Domain;
  unsigned long DomainLength;
  unsigned char *Password;
  unsigned long PasswordLength;
  unsigned long Flags;
} SEC_WINNT_AUTH_IDENTITY_A, *PSEC_WINNT_AUTH_IDENTITY_A;

Members

User

String containing the user name.

UserLength

Number of characters in User, excluding the terminating NULL.

Domain

String containing the domain or workgroup name.

DomainLength

Number of characters in Domain, excluding the terminating NULL.

Password

String containing the user's password in the domain or workgroup.

PasswordLength

Number of characters in Password, excluding the terminating NULL.

Flags

Flags used to specify ANSI or UNICODE. Must be one of the following:

SEC_WINNT_AUTH_IDENTITY_ANSI

SEC_WINNT_AUTH_IDENTITY_UNICODE

Remarks

This structure must remain valid for the lifetime of the binding handle unless pointed to from the RPC_HTTP_TRANSPORT_CREDENTIALS or RPC_HTTP_TRANSPORT_CREDENTIALS_V2 structure.

The strings may be ANSI or UNICODE depending on the value assigned to Flags.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header rpcdce.h (include Rpc.h)