ÉnumérationSecurityPackagesA, fonction (sspi.h)

Article
11/20/2024

La fonction EnumerateSecurityPackages retourne un tableau de structures SecPkgInfo qui fournissent des informations sur les packages de sécurité disponibles pour le client.

Syntaxe

SECURITY_STATUS SEC_ENTRY EnumerateSecurityPackagesA(
  [in] unsigned long *pcPackages,
  [in] PSecPkgInfoA  *ppPackageInfo
);

Paramètres

[in] pcPackages

Pointeur vers une variable ULONG qui reçoit le nombre de packages disponibles sur le système. Cela inclut les packages déjà chargés et les packages disponibles à la demande.

[in] ppPackageInfo

Pointeur vers une variable qui reçoit un pointeur vers un tableau de structures SecPkgInfo. Chaque structure contient des informations du fournisseur de support de sécurité (SSP) qui décrit les fonctionnalités du package de sécurité disponible dans ce fournisseur de services partagés.

Lorsque vous avez terminé d’utiliser le tableau, libérez la mémoire en appelant la fonction FreeContextBuffer.

Valeur de retour

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

Si la fonction échoue, elle retourne un code d’erreur différent de zéro. Les valeurs possibles incluent, mais ne sont pas limitées à celles du tableau suivant.

Retourner le code/la valeur	Description
SEC_E_INSUFFICIENT_MEMORY 0x80090300L	Il n’y avait pas suffisamment de mémoire pour allouer une ou plusieurs mémoires tampons.
SEC_E_INVALID_HANDLE 0x80090301L	Un handle non valide a été spécifié.
SEC_E_SECPKG_NOT_FOUND 0x80090305L	Le package spécifié n’a pas été trouvé.

Remarques

L’appelant peut utiliser le membre Name d’une structure SecPkgInfo pour spécifier un package de sécurité dans un appel à la fonction AcquireCredentialsHandle (Général).

Note

L’en-tête sspi.h définit EnumerateSecurityPackages comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	sspi.h (include Security.h)
bibliothèque	Secur32.lib
DLL	SspiCli.dll

Voir aussi

AcquireCredentialsHandle (Général)

FreeContextBuffer

fonctions SSPI

secPkgInfo

Partager via