structure KERB_CERTIFICATE_LOGON (ntsecapi.h)

La structure KERB_CERTIFICATE_LOGON contient des informations sur une session d’ouverture de session de carte intelligente.

Il est passé en tant que paramètre AuthenticationInformation à la fonction LsaLogonUser lorsque le package de sécurité Kerberos effectue une ouverture de session intelligente interactive carte.

Syntaxe

typedef struct _KERB_CERTIFICATE_LOGON {
  KERB_LOGON_SUBMIT_TYPE MessageType;
  UNICODE_STRING         DomainName;
  UNICODE_STRING         UserName;
  UNICODE_STRING         Pin;
  ULONG                  Flags;
  ULONG                  CspDataLength;
  PUCHAR                 CspData;
} KERB_CERTIFICATE_LOGON, *PKERB_CERTIFICATE_LOGON;

Membres

MessageType

Membre du KERB_LOGON_SUBMIT_TYPE énumération qui indique comment cette structure est utilisée. Le membre doit être l’une des valeurs suivantes.

DomainName

Nom de domaine de l’utilisateur à authentifier. La valeur de ce membre peut être vide. Si la valeur n’est pas vide, LsaLogonUser utilise la valeur pour localiser le centre de distribution de clés (KDC). Si la valeur est vide, LsaLogonUser tente de s’authentifier auprès du domaine auquel l’ordinateur est joint. Le pointeur est relatif au début de la structure et n’est pas un pointeur mémoire absolu.

UserName

Nom d’utilisateur de l’utilisateur à authentifier. La valeur de ce membre peut être vide. Si la valeur n’est pas vide, LsaLogonUser utilise la valeur pour localiser le compte d’utilisateur à authentifier. Le pointeur est relatif au début de la structure et n’est pas un pointeur mémoire absolu.

Pin

Code confidentiel à utiliser pour authentifier l’utilisateur. Le membre Length de cette structure n’inclut pas le caractère null de fin du code confidentiel. Le pointeur est relatif au début de la structure et n’est pas un pointeur mémoire absolu.

Le code confidentiel peut être protégé à l’aide de la fonction CredProtect .

Flags

Indicateurs facultatifs qui contrôlent le comportement de l’authentification. Les valeurs suivantes sont définies.

CspDataLength

Longueur, en caractères, du membre CspData .

CspData

Pointeur vers une structure de KERB_SMARTCARD_CSP_INFO qui contient des informations sur le fournisseur de services de chiffrement intelligent carte ou un pointeur vers une structure de KERB_CERTIFICATE_INFO marshalée lors de la mise à jour des informations d’identification de certificat.

Remarques

Cette structure, ainsi que les données pointées par les membres DomainName, UserName, Pin et CspData , sont contenues dans un seul bloc de mémoire contiguë. Lorsque cette structure est sérialisée, les décalages spécifiés par chacun de ces membres doivent être des multiples de deux.

Les pointeurs stockés dans les membres de UNICODE_STRING type sont relatifs au début de la structure et ne sont pas des pointeurs de mémoire absolus.

Configuration requise

Voir aussi

KERB_CERTIFICATE_UNLOCK_LOGON

KERB_SMARTCARD_CSP_INFO

LsaLogonUser