Fonction FreeCredentialsHandle (sspi.h)

  • Article

La fonction FreeCredentialsHandle avertit le système de sécurité que les informations d’identification ne sont plus nécessaires. Une application appelle cette fonction pour libérer le handle d’informations d’identification acquis dans l’appel à la fonction AcquireCredentialsHandle (Général) après l’appel de la fonction DeleteSecurityContext pour libérer tous les handles de contexte associés aux informations d’identification. Lorsque toutes les références à ce jeu d’informations d’identification ont été supprimées, les informations d’identification elles-mêmes peuvent être supprimées.

L’échec de la libération des handles d’informations d’identification entraîne des fuites de mémoire.

Syntaxe

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY FreeCredentialsHandle(
  [in] PCredHandle phCredential
);

Paramètres

[in] phCredential

Pointeur vers le handle CredHandle obtenu à l’aide de la fonction AcquireCredentialsHandle (Général).

Valeur retournée

Si la fonction réussit, la fonction retourne SEC_E_OK.

Si la fonction échoue, elle retourne le code d’erreur suivant.

Code de retour Description
SEC_E_INVALID_HANDLE
 Le handle passé à la fonction n’est pas valide.

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 sspi.h (include Security.h)
Bibliothèque Secur32.lib
DLL Secur32.dll

Voir aussi

AcquireCredentialsHandle (Général)

Fonctions SSPI