Fonction de rappel SpAddCredentialsFn (ntsecpkg.h)

Article
03/06/2024

Permet d’ajouter des informations d’identification pour un principal de sécurité.

Syntaxe

SpAddCredentialsFn Spaddcredentialsfn;

NTSTATUS Spaddcredentialsfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [in]  PUNICODE_STRING PrincipalName,
  [in]  PUNICODE_STRING Package,
  [in]  ULONG CredentialUseFlags,
  [in]  PVOID AuthorizationData,
        PVOID GetKeyFunciton,
  [in]  PVOID GetKeyArgument,
  [out] PTimeStamp ExpirationTime
)
{...}

Paramètres

[in] CredentialHandle

Handle aux informations d’identification à ajouter.

[in] PrincipalName

facultatif. Pointeur vers une structure UNICODE_STRING contenant le nom du principal de sécurité dont les informations d’identification sont ajoutées.

[in] Package

Pointeur vers une structure UNICODE_STRING contenant le nom du package d’authentification.

[in] CredentialUseFlags

Indicateurs indiquant la façon dont les informations d’identification seront utilisées. Les valeurs suivantes sont valides.

Valeur	Signification
SECPKG_CRED_INBOUND	Les informations d’identification seront utilisées avec la fonction AcceptSecurityContext (Général).
SECPKG_CRED_OUTBOUND	Les informations d’identification seront utilisées avec la fonction InitializeSecurityContext (Général).

[in] AuthorizationData

facultatif. Pointeur vers des données d’authentification supplémentaires.

GetKeyFunciton

[in] GetKeyArgument

Pointeur vers l’argument utilisé avec la fonction GetKeyFunction .

[out] ExpirationTime

Pointeur vers un TimeStamp qui reçoit l’heure d’expiration du handle d’informations d’identification.

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

SSP/APs doivent implémenter la fonction SpAddCredentials ; toutefois, le nom réel donné à l’implémentation appartient au développeur.

Un pointeur vers la fonction SpAddCredentials est disponible dans 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

Voir aussi

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize

Partager via