Fonction WintrustAddActionID (wintrust.h)

  • Article

[La fonction WintrustAddActionID est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Pour la vérification des certificats, utilisez les fonctions CertGetCertificateChain et CertVerifyCertificateChainPolicy . Pour la vérification de la signature de la technologie Microsoft Authenticode , utilisez .NET Framework.]

La fonction WintrustAddActionID ajoute une action de fournisseur d’approbation au système de l’utilisateur. Cette méthode doit être appelée lors de l’implémentation de DllRegisterServer du fournisseur d’approbation. Cette fonction n’a pas de bibliothèque d’importation associée. Vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour établir un lien dynamique vers Wintrust.dll.

Cette méthode doit être appelée uniquement par un fournisseur d’approbation.

Syntaxe

BOOL WintrustAddActionID(
  [in] GUID                    *pgActionID,
  [in] DWORD                   fdwFlags,
  [in] CRYPT_REGISTER_ACTIONID *psProvInfo
);

Paramètres

[in] pgActionID

Pointeur vers une structure GUID qui identifie l’action à ajouter et le fournisseur d’approbation qui prend en charge cette action.

Le service WinTrust est conçu pour fonctionner avec des fournisseurs d’approbation implémentés par des tiers. Chaque fournisseur d’approbation fournit son propre ensemble unique d’identificateurs d’action. Pour plus d’informations sur les identificateurs d’action pris en charge par un fournisseur d’approbation, consultez la documentation relative à ce fournisseur d’approbation.

Par exemple, Microsoft fournit un fournisseur d’approbation d’éditeur de logiciels qui peut établir la fiabilité des logiciels téléchargés à partir d’Internet ou d’un autre réseau public. Le fournisseur d’approbation de l’éditeur de logiciels prend en charge les identificateurs d’action suivants. Ces constantes sont définies dans Softpub.h.

Valeur Signification
WINTRUST_ACTION_GENERIC_VERIFY
 Vérifiez une chaîne de certificats uniquement.
WINTRUST_ACTION_GENERIC_VERIFY_V2
 Vérifiez un fichier ou un objet à l’aide du fournisseur de stratégie Authenticode.
HTTPSPROV_ACTION
 Vérifiez une connexion SSL/PCT via Internet Explorer.

[in] fdwFlags

valeur qui détermine si les erreurs de Registre sont signalées par cette fonction. Si fdwFlags est égal à zéro et que cette fonction rencontre une erreur de Registre, l’erreur de Registre ne sera pas propagée à la fonction GetLastError . Si fdwFlags est WT_ADD_ACTION_ID_RET_RESULT_FLAG (0x1) et que cette fonction rencontre une erreur de Registre, l’erreur de Registre est propagée à la fonction GetLastError .

[in] psProvInfo

Pointeur vers la structure CRYPT_REGISTER_ACTIONID qui définit les informations pour le fournisseur d’approbation.

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. Pour plus d’informations sur les erreurs de Registre que cette fonction peut rencontrer, consultez la description de fdwFlags.

Remarques

Pour supprimer une action qui a été ajoutée par cette fonction, appelez la fonction WintrustRemoveActionID .

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

WintrustRemoveActionID