Fonction WinVerifyTrustEx (wintrust.h)

La fonction WinVerifyTrustEx effectue une action de vérification d’approbation sur un objet spécifié et prend un pointeur vers une structure WINTRUST_DATA . La fonction transmet l’enquête à un fournisseur d’approbation, le cas échéant, qui prend en charge l’identificateur d’action.

Pour la vérification des certificats, utilisez les fonctions CertGetCertificateChain et CertVerifyCertificateChainPolicy .

Syntaxe

long WinVerifyTrustEx(
  [in] HWND          hwnd,
  [in] GUID          *pgActionID,
  [in] WINTRUST_DATA *pWinTrustData
);

Paramètres

[in] hwnd

Handle facultatif vers une fenêtre d’appelant. Un fournisseur d’approbation peut utiliser cette valeur pour déterminer s’il peut interagir avec l’utilisateur. Toutefois, les fournisseurs d’approbation effectuent généralement des actions de vérification sans entrée de l’utilisateur.

Ce paramètre peut être l’une des valeurs suivantes.

[in] pgActionID

Pointeur vers une structure GUID qui identifie une action et le fournisseur d’approbation qui prend en charge cette action. Cette valeur indique le type d’action de vérification à effectuer sur la structure pointée par pWinTrustData.

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 de 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] pWinTrustData

Pointeur vers une structure WINTRUST_DATA qui contient des informations que le fournisseur d’approbation doit traiter l’identificateur d’action spécifié. En règle générale, la structure inclut des informations qui identifient l’objet que le fournisseur d’approbation doit évaluer.

Le format de la structure dépend de l’identificateur d’action. Pour plus d’informations sur les données requises pour un identificateur d’action spécifique, consultez la documentation du fournisseur d’approbation qui prend en charge cette action.

Valeur de retour

Notez que si le type de retour est déclaré comme HRESULT, cette API retourne des codes d’erreur Win32, n’utilisez pas SUCCEEDED() ou FAILED() pour tester le résultat.

Si le fournisseur d’approbation vérifie que l’objet est approuvé pour l’action spécifiée, la valeur de retour est ERROR_SUCCESS. Sinon, la fonction retourne un code d’état du fournisseur d’approbation.

Par exemple, un fournisseur d’approbation peut indiquer que le sujet n’est pas approuvé ou est approuvé, mais avec des limitations ou des avertissements. La valeur de retour peut être une valeur spécifique à un fournisseur d’approbation décrite dans la documentation d’un fournisseur d’approbation individuel, ou il peut s’agir de l’un des codes d’erreur suivants.

Spécifications