ICertificates2::Find, méthode

  • Article

[CAPICOM est un composant 32 bits uniquement disponible pour une utilisation dans les systèmes d’exploitation suivants : Windows Server 2008, Windows Vista et Windows XP. Utilisez plutôt la classe X509Certificate2Collection dans l’espace de noms System.Security.Cryptography.X509Certificates .]

La méthode Find retourne un objet Certificates qui contient tous les certificats qui correspondent aux critères de recherche spécifiés. Cette méthode a été introduite dans CAPICOM 2.0.

Syntaxe

Certificates.Find( _
  ByVal FindType, _
  [ ByVal varCriteria ], _
  [ ByVal bFindValidOnly ] _
)

Paramètres

FindType [in]

Valeur de l’énumération CAPICOM_CERTIFICATE_FIND_TYPE qui spécifie le type de critères de correspondance fournis dans le paramètre varCriteria . Le tableau suivant répertorie les valeurs possibles.

Value Signification
CAPICOM_CERTIFICATE_FIND_SHA1_HASH
 Retourne des certificats avec un hachage SHA1 qui correspond au hachage SHA1 spécifié dans le paramètre varCriteria .
CAPICOM_CERTIFICATE_FIND_SUBJECT_NAME
 Retourne des certificats dont le nom d’objet correspond exactement ou partiellement au nom de l’objet spécifié dans le paramètre varCriteria . Cet appel recherche uniquement le champ nom de l’objet.
CAPICOM_CERTIFICATE_FIND_ISSUER_NAME
 Retourne des certificats dont le nom de l’émetteur correspond exactement ou partiellement au nom de l’émetteur spécifié dans le paramètre varCriteria . Cet appel recherche uniquement le champ nom de l’émetteur.
CAPICOM_CERTIFICATE_FIND_ROOT_NAME
 Retourne des certificats dont le nom d’objet racine correspond exactement ou partiellement au nom d’objet racine spécifié dans le paramètre varCriteria . Cet appel crée une chaîne. Cet appel recherche le champ de nom d’objet du certificat racine.
CAPICOM_CERTIFICATE_FIND_TEMPLATE_NAME
 Retourne des certificats dont le nom de modèle correspond au nom de modèle spécifié dans le paramètre varCriteria .
CAPICOM_CERTIFICATE_FIND_EXTENSION
 Retourne les certificats qui ont une extension qui correspond à l’extension spécifiée dans le paramètre varCriteria .
CAPICOM_CERTIFICATE_FIND_EXTENDED_PROPERTY
 Retourne des certificats dans le magasin qui contiennent explicitement une propriété étendue avec la valeur spécifiée dans le paramètre varCriteria .
CAPICOM_CERTIFICATE_FIND_APPLICATION_POLICY
 Retourne des certificats dans le magasin qui ont une extension d’utilisation de clé améliorée, une extension de stratégie d’application ou une propriété étendue spécifiée dans le paramètre varCriteria .
CAPICOM_CERTIFICATE_FIND_CERTIFICATE_POLICY
 Retourne les certificats qui contiennent l’OID de stratégie dans l’extension de stratégie de certificat spécifiée dans le paramètre varCriteria .
CAPICOM_CERTIFICATE_FIND_TIME_VALID
 Retourne des certificats dont l’heure est valide.
CAPICOM_CERTIFICATE_FIND_TIME_NOT_YET_VALID
 Retourne des certificats dont l’heure n’est pas encore valide.
CAPICOM_CERTIFICATE_FIND_TIME_EXPIRED
 Retourne les certificats dont le délai a expiré.
CAPICOM_CERTIFICATE_FIND_KEY_USAGE
 Retourne des certificats contenant des utilisations de clé dans l’extension KeyUsage spécifiée dans le paramètre varCriteria . Si l’extension KeyUsage n’est pas présente, toutes les utilisations de clé sont supposées être indisponibles.

 

varCriteria [in, facultatif]

Variante qui contient les critères de recherche. Ces données doivent correspondre au type de données spécifié dans le paramètre FindType . Si la valeur du paramètre FindType est CAPICOM_CERTIFICATE_FIND_TIME_VALID, CAPICOM_CERTIFICATE_FIND_TIME_NOT_YET_VALID ou CAPICOM_CERTIFICATE_FIND_TIME_EXPIRED et que vous ne transmettez pas de valeur à ce paramètre, l’heure actuelle est supposée. Pour obtenir des exemples de chaque type de données, consultez Remarques. La valeur par défaut est 0.

bFindValidOnly [in, facultatif]

Valeur booléenne qui indique si seuls les certificats valides sont retournés. La valeur par défaut est false ; cela indique que tous les certificats qui correspondent aux critères de recherche sont retournés.

Si la valeur est true, la recherche ne retourne pas les types de certificats suivants :

  • Certificats dont le délai a expiré ou n’est pas encore valide.
  • Les certificats ne sont pas correctement chaînés.
  • Certificats qui ont des problèmes de signature.
  • Certificats révoqués.

Valeur retournée

Objet Certificates qui contient les résultats de la recherche.

CAPICOM 2.1 : L’objet Certificates retourné contient des références aux certificats de la collection dans laquelle la recherche a été effectuée. Toutes les modifications apportées aux certificats dans l’objet Certificates retourné sont répercutées dans cette collection.

CAPICOM 2.0, CAPICOM 2.0.0.1, CAPICOM 2.0.0.2 et CAPICOM 2.0.0.3 : L’objet Certificates retourné contient des copies des certificats de la collection dans laquelle la recherche a été effectuée. Les modifications apportées aux certificats dans l’objet Certificates retourné ne sont pas répercutées dans cette collection.

Notes

Les exemples suivants montrent les critères de recherche possibles pour les différents types de critères de recherche.

Paramètre FindType paramètre varCriteria
CAPICOM_CERTIFICATE_FIND_SHA1_HASH 33F362434B577F844BB7226BE36F7D72EF9D9393
CAPICOM_CERTIFICATE_FIND_SUBJECT_NAME « NameOfPerson »
CAPICOM_CERTIFICATE_FIND_ISSUER_NAME « VeriSign »
CAPICOM_CERTIFICATE_FIND_ROOT_NAME « Microsoft Root Authority »
CAPICOM_CERTIFICATE_FIND_TEMPLATE_NAME « AutoEnrollEFS »
1.3.6.1.4.1.311.21.8.3692315854.1256661383.1690418588.4201632533.1741915387.2177932052
CAPICOM_CERTIFICATE_FIND_EXTENSION "2.5.29.31"
CAPICOM_OID_KEY_USAGE_EXTENSION
« Liste de distribution de liste de révocation de certificats »
CAPICOM_CERTIFICATE_FIND_EXTENDED_PROPERTY CAPICOM_PROPID_KEY_PROV_INFO
CAPICOM_CERTIFICATE_FIND_APPLICATION_POLICY "1.3.6.1.5.5.7.3.3"
"1.3.6.1.5.5.7.3.4"
CAPICOM_OID_SERVER_AUTH_EKU
« Signature de code »
CAPICOM_CERTIFICATE_FIND_CERTIFICATE_POLICY "1.3.6.1.5.5.7.3.4.3.5"
« Corporate High Assurance »
CAPICOM_CERTIFICATE_FIND_TIME_VALID #15/04/2002, 18:00 #
CAPICOM_CERTIFICATE_FIND_TIME_NOT_YET_VALID #15/04/2002, 18:00 #
CAPICOM_CERTIFICATE_FIND_TIME_EXPIRED #15/04/2002, 18:00 #
CAPICOM_CERTIFICATE_FIND_KEY_USAGE CAPICOM_ENCIPHER_ONLY_KEY_USAGE

 

Spécifications

Condition requise Valeur
Fin de la prise en charge des clients
 Windows Vista
Fin de la prise en charge des serveurs
 Windows Server 2008
Composant redistribuable
 CAPICOM 2.0 ou version ultérieure sur Windows Server 2003 et Windows XP
DLL
Capicom.dll

Voir aussi

Certificats

CAPICOM_OID