SslGetProviderProperty, fonction

La fonction SslGetProviderProperty récupère la valeur d’une propriété de fournisseur spécifiée.

Syntaxe

SECURITY_STATUS WINAPI SslGetProviderProperty(
  _In_    NCRYPT_PROV_HANDLE hSslProvider,
  _In_    LPCWSTR            pszProperty,
  _Out_   PBYTE              ppbOutput,
  _Out_   DWORD              *pcbOutput,
  _Inout_ PVOID              *ppEnumState,
  _In_    DWORD              dwFlags
);

Paramètres

hSslProvider [in]

Handle du fournisseur SSL ( Secure Sockets Layer ) pour lequel récupérer la propriété.

pszProperty [in]

Pointeur vers une chaîne Unicode terminée par null qui contient le nom de la propriété à récupérer.

ppbOutput [out]

Adresse d’une mémoire tampon qui reçoit la valeur de la propriété.

L’appelant de la fonction doit libérer cette mémoire tampon en appelant la fonction SslFreeBuffer .

ccpOutput [out]

Taille, en octets, de la mémoire tampon pbOutput .

ppEnumState [in, out]

Adresse d’un pointeur VOID qui reçoit des informations d’état d’énumération utilisées dans les appels suivants à cette fonction. Ces informations ont uniquement une signification pour le fournisseur SSL et sont opaques pour l’appelant. Le fournisseur SSL utilise ces informations pour déterminer l’élément suivant dans l’énumération. Si la variable pointée par ce paramètre contient NULL, l’énumération est démarrée à partir du début.

L’appelant de la fonction doit libérer cette mémoire en appelant la fonction SslFreeBuffer .

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 non nulle.

Les codes de retour possibles incluent, mais ne sont pas limités à, les éléments suivants.

Code/valeur de retour	Description
NTE_NO_MEMORY 0x8009000EL	La mémoire n’est pas suffisante pour allouer les mémoires tampons nécessaires.
NTE_INVALID_HANDLE 0x80090026L	Le handle hSslProvider n’est pas valide.
NTE_INVALID_PARAMETER 0x80090027L	L’un des paramètres fournis n’est pas valide.

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