Fonction FreeCredentialsHandle (sspi.h)
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 |
|---|---|
|
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 |