IX509PrivateKey ::Verify, méthode (certenroll.h)

  • Article

La méthode Verify vérifie qu’une clé privée existe et peut être utilisée par le client, mais n’ouvre pas la clé.

Syntaxe

HRESULT Verify(
  [in] X509PrivateKeyVerify VerifyType
);

Paramètres

[in] VerifyType

Valeur d’énumération X509PrivateKeyVerify qui spécifie les options d’exécution de la méthode . Il peut s’agir de l’une des valeurs suivantes.

Valeur Signification
VerifyNone
 Ne vérifie pas.
VerifySilent
 Ne vérifie pas si une interface utilisateur est nécessaire pour ouvrir la clé privée ; sinon, la vérification se produit. Pour plus d'informations, consultez la section Notes.
VerifySmartCardNone
 Ne vérifie pas si la clé est stockée sur un carte intelligent ; sinon, cette valeur équivaut à VerifyAllowUI.
VerifySmartCardSilent
 Ne vérifie pas si une interface utilisateur est nécessaire pour ouvrir la clé privée et si la clé est stockée sur un carte intelligent ; sinon, cette valeur équivaut à VerifyAllowUI. Pour plus d'informations, consultez la section Notes.
VerifyAllowUI
 La méthode permet d’afficher une interface utilisateur.

Valeur retournée

Si la fonction réussit, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles sont notamment celles figurant dans le tableau suivant. En outre, cette méthode appelle les fonctions CryptoAPI CryptGetUserKey et CryptAcquireContext et peut retourner les erreurs identifiées dans cette documentation. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Code de retour Description
CERTSRV_E_PROPERTY_EMPTY
 Les propriétés liées au fournisseur de solutions Cloud ou KSP sont introuvables.

Remarques

Si des valeurs VerifySilent ou VerifySmartCardSilent sont définies et que le fournisseur de chiffrement spécifie qu’une interface utilisateur est nécessaire, la clé n’est pas ouverte, mais la méthode retourne S_OK.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête certenroll.h
DLL CertEnroll.dll

Voir aussi

IX509PrivateKey