WintrustGetDefaultForUsage, fonction (wintrust.h)
La fonction WintrustGetDefaultForUsage récupère l’identificateur d’utilisation par défaut et les informations de rappel.
Syntaxe
BOOL WintrustGetDefaultForUsage(
[in] DWORD dwAction,
[in] const char *pszUsageOID,
[in, out] CRYPT_PROVIDER_DEFUSAGE *psUsage
);
Paramètres
[in] dwAction
Action à effectuer. Il peut s’agir de l’une des valeurs suivantes. Pour plus d'informations, consultez la section Notes.
| Valeur | Signification |
|---|---|
|
Allouez de la mémoire et remplissez la structure CRYPT_PROVIDER_DEFUSAGE pointée par le paramètre psUsage . |
|
Libérez toute la mémoire allouée lors d’un appel précédent à cette fonction en spécifiant DWACTION_ALLOCANDFILL pour ce paramètre. |
[in] pszUsageOID
Pointeur vers une chaîne qui contient l’identificateur.
[in, out] psUsage
Pointeur vers une structure de CRYPT_PROVIDER_DEFUSAGE qui contient des informations de rappel à récupérer.
Valeur retournée
La valeur de retour est TRUE si la fonction réussit ; FALSE si la fonction échoue. Si la fonction échoue, appelez la fonction GetLastError pour déterminer la raison de l’échec.
Remarques
Appelez cette fonction une fois avec le paramètre dwAction défini sur DWACTION_ALLOCANDFILL pour allouer de la mémoire et remplir une structure de CRYPT_PROVIDER_DEFUSAGE avec des informations. Appelez à nouveau cette fonction avec le paramètre dwAction défini sur DWACTION_FREE pour libérer la mémoire allouée.
Les informations d’utilisation et de rappel par défaut d’un fournisseur sont inscrites en appelant la fonction WintrustAddDefaultForUsage .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | wintrust.h |
| Bibliothèque | Wintrust.lib |
| DLL | Wintrust.dll |