SslOpenProvider, fonction

Article
06/13/2023

La fonction SslOpenProvider ouvre un handle au fournisseur de protocole SSL ( Secure Sockets Layer ) spécifié.

Syntaxe

SECURITY_STATUS WINAPI SslOpenProvider(
  _Out_ NCRYPT_PROV_HANDLE *phSslProvider,
  _In_  LPCWSTR            pszProviderName,
  _In_  DWORD              dwFlags
);

Paramètres

phSslProvider [out]

Adresse d’un NCRYPT_PROV_HANDLE dans lequel écrire le handle du fournisseur.

Une fois que vous avez terminé d’utiliser le handle, vous devez le libérer en appelant la fonction SslFreeObject .

pszProviderName [in]

Pointeur vers une chaîne Unicode qui contient le nom du fournisseur. Si la valeur de ce paramètre est NULL, un handle au MS_SCHANNEL_PROVIDER est retourné.

dwFlags [in]

Ce paramètre est réservé pour une utilisation ultérieure et doit être défini sur zéro.

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_INVALID_HANDLE 0x80090026L	L’un des handles fournis n’est pas valide.
NTE_INVALID_PARAMETER 0x80090027L	Le paramètre phSslProvider ou ppProviderList est NULL.
STATUS_NO_MEMORY 0xC0000017L	La mémoire disponible est insuffisante pour allouer les mémoires tampons nécessaires.

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