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

  • Article
  • 2 minutes de lecture

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 requise 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 une carte à puce ; sinon, cette valeur équivaut à VerifyAllowUI.
VerifySmartCardSilent
 Ne vérifie pas si une interface utilisateur est requise pour ouvrir la clé privée et que la clé est stockée sur une carte à puce; sinon, cette valeur équivaut à VerifyAllowUI. Pour plus d'informations, consultez la section Notes.
VerifyAllowUI
 La méthode permet à une interface utilisateur d’être affichée.

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. De plus, cette méthode appelle les fonctions CryptGetUserKey et CryptAcquireContext CryptoAPI et peuvent retourner des 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 n’ont pas pu être trouvées.

Notes

Si les 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

   
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