Fonction WintrustAddActionID (wintrust.h)
[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.
[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 |