Fonction SslEnumProtocolProviders

Article
06/12/2023

La fonction SslEnumProtocolProviders retourne un tableau de fournisseurs de protocole SSL ( Secure Sockets Layer Protocol) installés.

Syntaxe

SECURITY_STATUS WINAPI SslEnumProtocolProviders(
  _Out_ DWORD              *pdwProviderCount,
  _Out_ NCryptProviderName **ppProviderList,
  _In_  DWORD              dwFlags
);

Paramètres

pdwProviderCount [out]: Pointeur vers une valeur DWORD pour recevoir le nombre de fournisseurs de protocole retournés.
ppProviderList [out]: Pointeur vers une mémoire tampon qui reçoit le tableau des structures NCryptProviderName .
dwFlags [in]: Ce paramètre est réservé à un usage futur.

Valeur retournée

Si la fonction réussit, elle retourne zéro.

Si la fonction échoue, elle retourne une valeur d’erreur différente de zéro.

Les codes de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code/valeur de retour	Description
NTE_BAD_FLAGS 0x80090009L	Le paramètre dwFlags n’est pas égal à zéro.
NTE_NO_MEMORY 0x8009000EL	La mémoire disponible est insuffisante pour allouer les mémoires tampons nécessaires.
NTE_INVALID_PARAMETER 0x80090027L	Le paramètre pdwProviderCount ou ppProviderList a la valeur NULL.

Notes

Une fois que vous avez terminé d’utiliser le tableau des structures NCryptProviderName , appelez la fonction SslFreeBuffer pour libérer le tableau.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	Sslprovider.h
DLL	Ncrypt.dll

Partager via