WintrustGetDefaultForUsage, fonction (wintrust.h)

  • Article

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
DWACTION_ALLOCANDFILL
 Allouez de la mémoire et remplissez la structure CRYPT_PROVIDER_DEFUSAGE pointée par le paramètre psUsage .
DWACTION_FREE
 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

Voir aussi

CRYPT_PROVIDER_DEFUSAGE

CRYPT_PROVIDER_REGDEFUSAGE

WintrustAddDefaultForUsage