Fonction de rappel SpAcceptCredentialsFn (ntsecpkg.h)

Article
02/29/2024

Appelée par l’autorité de sécurité locale (LSA) pour transmettre au package de sécurité toutes les informations d’identification stockées pour le principal de sécurité authentifié. Cette fonction est appelée une fois pour chaque ensemble d’informations d’identification stockées par le LSA.

Syntaxe

SpAcceptCredentialsFn Spacceptcredentialsfn;

NTSTATUS Spacceptcredentialsfn(
  [in] SECURITY_LOGON_TYPE LogonType,
  [in] PUNICODE_STRING AccountName,
  [in] PSECPKG_PRIMARY_CRED PrimaryCredentials,
  [in] PSECPKG_SUPPLEMENTAL_CRED SupplementalCredentials
)
{...}

Paramètres

[in] LogonType

Valeur SECURITY_LOGON_TYPE indiquant le type d’ouverture de session.

[in] AccountName

Pointeur vers une structure UNICODE_STRING spécifiant le nom du compte connecté.

[in] PrimaryCredentials

Pointeur vers une structure SECPKG_PRIMARY_CRED contenant les informations d’identification utilisées pour l’ouverture de session. Cette structure peut avoir des membres NULL .

[in] SupplementalCredentials

Pointeur vers une structure SECPKG_SUPPLEMENTAL_CRED contenant des informations d’identification supplémentaires spécifiques au package.

Valeur retournée

Si la fonction réussit, retournez STATUS_SUCCESS.

Si la fonction échoue, retourne un code NTSTATUS qui indique la raison de son échec.

Remarques

Le package de sécurité doit enregistrer les informations d’identification afin de pouvoir traiter les demandes d’informations d’identification. Pour plus d’informations, consultez la fonction SpAcquireCredentialsHandle .

SSP/APs doivent implémenter la fonction SpAcceptCredentials ; contrairement aux autres fonctions SSP/AP, le nom de la fonction doit être SpAcceptCredentials.

Le LSA accède à la fonction SpAcceptCredentials via la structure SECPKG_FUNCTION_TABLE reçue de la fonction SpLsaModeInitialize .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ntsecpkg.h