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 |
|---|---|
|
La mémoire disponible est insuffisante pour allouer les tampons nécessaires. |
|
Le descripteur hSslProvider n’est pas 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 |
|
| DLL |
|