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 [ dans]

Handle du fournisseur SSL ( SSL (Secure Sockets Layer) Protocol ) pour lequel la propriété doit être récupérée.

pszProperty [ dans]

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

ppbOutput [ à]

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 .

pcbOutput [ à]

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

ppEnumState [ in, out]

Adresse d’un pointeur void qui reçoit les informations d’état d’énumération utilisées dans les appels ultérieurs à cette fonction. Ces informations n’ont qu’une signification pour le fournisseur SSL et sont opaques pour l’appelant. Le fournisseur SSL utilise ces informations pour déterminer l’élément qui est ensuite dans l’énumération. Si la variable vers laquelle pointe ce paramètre contient la valeur 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 [ dans]

Ce paramètre est réservé à un usage futur.

Valeur de retour

Si la fonction est réussie, 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, mais ne sont pas limités à, les éléments suivants.

Code/valeur de retour Description
NPD _ AUCUNE _ mémoire
0x8009000EL
La mémoire disponible est insuffisante pour allouer les tampons nécessaires.
NPD _ _Handle 0X80090026L non valide
Le descripteur hSslProvider n’est pas valide.
NPD _ _Paramètre 0X80090027L non valide
L’un des paramètres fournis n’est pas valide.

Spécifications

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