ICertificates2::Find-Methode

[CAPICOM ist eine nur 32-Bit-Komponente, die für die Verwendung in den folgenden Betriebssystemen verfügbar ist: Windows Server 2008, Windows Vista und Windows XP. Verwenden Sie stattdessen die X509Certificate2Collection-Klasse im Namespace System.Security.Cryptography.X509Certificates.]

Die Find-Methode gibt ein Certificates-Objekt zurück, das alle Zertifikate enthält, die den angegebenen Suchkriterien entsprechen. Diese Methode wurde in CAPICOM 2.0 eingeführt.

Syntax

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

Parameter

FindType [ In]

Ein Wert der CAPICOM _ CERTIFICATE FIND _ _ TYPE-Enumeration, der den Typ der im varCriteria-Parameter angegebenen Übereinstimmungskriterien angibt. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert Bedeutung
CAPICOM _ CERTIFICATE _ FIND _ SHA1 _ HASH
Gibt Zertifikate mit einem SHA1-Hash zurück, der dem im varCriteria-Parameter angegebenen SHA1-Hash entspricht.
NAME _ DES ANTRAGSTELLERS FÜR CAPICOM-ZERTIFIKATSUCHE _ _ _
Gibt Zertifikate zurück, deren Antragstellername genau oder teilweise mit dem im varCriteria-Parameter angegebenen Antragstellernamen übereinstimmt. Dieser Aufruf durchsucht nur das Feld "Antragstellername".
NAME _ DES _ CAPICOM-ZERTIFIKATS ZUM SUCHEN _ DES _ AUSSTELLERS
Gibt Zertifikate zurück, deren Ausstellername genau oder teilweise mit dem im varCriteria-Parameter angegebenen Ausstellernamen übereinstimmt. Dieser Aufruf durchsucht nur das Feld ausstellername.
CAPICOM _ CERTIFICATE _ FIND _ ROOT _ NAME
Gibt Zertifikate zurück, deren Name des Stammsubjekts genau oder teilweise mit dem im varCriteria-Parameter angegebenen Stammsubjektnamen übereinstimmt. Dieser Aufruf erstellt eine Kette. Dieser Aufruf durchsucht das Feld antragstellername des Stammzertifikats.
NAME DER _ _ _ CAPICOM-ZERTIFIKATSUCHEVORLAGE _
Gibt Zertifikate zurück, deren Vorlagenname mit dem im varCriteria-Parameter angegebenen Vorlagennamen übereinstimmt.
ERWEITERUNG FÜR DIE _ CAPICOM-ZERTIFIKATSUCHE _ _
Gibt Zertifikate zurück, die über eine Erweiterung verfügen, die mit der im varCriteria-Parameter angegebenen Erweiterung übereinstimmt.
CAPICOM _ CERTIFICATE _ FIND _ EXTENDED _ PROPERTY
Gibt Zertifikate im Speicher zurück, die explizit eine erweiterte Eigenschaft mit dem im varCriteria-Parameter angegebenen Wert enthalten.
CAPICOM _ CERTIFICATE _ FIND _ APPLICATION _ POLICY
Gibt Zertifikate im Speicher zurück, die entweder eine erweiterte Schlüsselverwendungserweiterung, eine Anwendungsrichtlinienerweiterung oder eine erweiterte Eigenschaft aufweisen, die im varCriteria-Parameter angegeben ist.
_ZERTIFIKATSSUCHE-RICHTLINIE FÜR _ CAPICOM-ZERTIFIKATE _ _
Gibt Zertifikate zurück, die die Richtlinien-OID in der im varCriteria-Parameter angegebenen Zertifikatrichtlinienerweiterung enthalten.
CAPICOM _ CERTIFICATE _ FIND _ TIME _ VALID
Gibt Zertifikate zurück, deren Zeit gültig ist.
CAPICOM _ CERTIFICATE FIND TIME NOT YET VALID (CAPICOM-ZERTIFIKATSSUCHEZEIT _ NOCH NICHT _ _ _ _ GÜLTIG)
Gibt Zertifikate zurück, deren Zeit noch nicht gültig ist.
ABGELAUFENE ZEIT FÜR _ CAPICOM-ZERTIFIKATSUCHE _ _ _
Gibt Zertifikate zurück, deren Zeit abgelaufen ist.
VERWENDUNG DES _ CAPICOM-ZERTIFIKATS _ ZUR _ _ SCHLÜSSELSUCHE
Gibt Zertifikate zurück, die Schlüsselverwendungen in der im varCriteria-Parameter angegebenen KeyUsage-Erweiterung enthalten. Wenn die KeyUsage-Erweiterung nicht vorhanden ist, wird davon ausgegangen, dass alle Schlüsselverwendungen nicht verfügbar sind.

varCriteria [ in, optional]

Eine Variante, die die Suchkriterien enthält. Diese Daten müssen mit dem Im FindType-Parameter angegebenen Datentyp übereinstimmen. Wenn der Wert des FindType-Parameters CAPICOM _ CERTIFICATE FIND TIME _ _ _ VALID, CAPICOM _ CERTIFICATE FIND TIME NOT YET VALID oder _ _ _ _ _ CAPICOM CERTIFICATE FIND TIME EXPIRED lautet und Sie _ keinen Wert an diesen _ Parameter _ _ übergeben, wird die aktuelle Zeit angenommen. Beispiele für jeden Datentyp finden Sie unter Hinweise. Der Standardwert ist 0.

bFindValidOnly [ in, optional]

Ein boolescher Wert, der angibt, ob nur gültige Zertifikate zurückgegeben werden. Der Standardwert ist "false". gibt an, dass alle Zertifikate zurückgegeben werden, die den Suchkriterien entsprechen.

True gibt bei der Suche nicht die folgenden Zertifikattypen zurück:

  • Zertifikate, deren Zeit abgelaufen ist oder noch nicht gültig ist.
  • Zertifikate werden nicht ordnungsgemäß verkettet.
  • Zertifikate mit Signaturproblemen.
  • Zertifikate, die widerrufen werden.

Rückgabewert

Certificates-Objekt, das die Ergebnisse der Suche enthält.

CAPICOM 2.1: Das zurückgegebene Certificates-Objekt enthält Verweise auf die Zertifikate in der Auflistung, in der die Suche durchgeführt wurde. Alle Änderungen, die an den Zertifikaten im zurückgegebenen Certificates-Objekt vorgenommen werden, werden in dieser Auflistung widergespiegelt.

CAPICOM 2.0, CAPICOM 2.0.0.1, CAPICOM 2.0.0.2 und CAPICOM 2.0.0.3: Das zurückgegebene Certificates-Objekt enthält Kopien der Zertifikate in der Auflistung, in der die Suche durchgeführt wurde. Änderungen an den Zertifikaten im zurückgegebenen Certificates-Objekt werden in dieser Auflistung nicht widergespiegelt.

Hinweise

Die folgenden Beispiele zeigen mögliche Suchkriterien für die verschiedenen Suchkriterientypen.

FindType-Parameter varCriteria-Parameter
CAPICOM _ CERTIFICATE _ FIND _ SHA1 _ HASH 33F362434B577F844BB7226BE36F7D72EF9D9393
NAME _ DES ANTRAGSTELLERS FÜR CAPICOM-ZERTIFIKATSUCHE _ _ _ "NameOfPerson"
NAME _ DES _ CAPICOM-ZERTIFIKATS ZUM SUCHEN _ DES _ AUSSTELLERS "VeriSign"
CAPICOM _ CERTIFICATE _ FIND _ ROOT _ NAME "Microsoft-Stammzertifizierungsstelle"
NAME DER _ _ _ CAPICOM-ZERTIFIKATSUCHEVORLAGE _ "AutoEnrollEFS"
1.3.6.1.4.1.311.21.8.3692315854.1256661383.1690418588.4201632533.1741915387.2177932052
ERWEITERUNG FÜR DIE _ CAPICOM-ZERTIFIKATSUCHE _ _ "2.5.29.31"
_ _ _ CAPICOM-OIDSCHLÜSSELVERWENDUNGSERWEITERUNG _
"CRL-Verteilerliste"
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
"Codesignierung"
_ZERTIFIKATSSUCHE-RICHTLINIE FÜR _ CAPICOM-ZERTIFIKATE _ _ "1.3.6.1.5.5.7.3.4.3.5"
"Corporate High Assurance"
CAPICOM _ CERTIFICATE _ FIND _ TIME _ VALID #15.04.2002, 18:00 Uhr#
CAPICOM _ CERTIFICATE FIND TIME NOT YET VALID (CAPICOM-ZERTIFIKATSSUCHEZEIT _ NOCH NICHT _ _ _ _ GÜLTIG) #15.04.2002, 18:00 Uhr#
ABGELAUFENE ZEIT FÜR _ CAPICOM-ZERTIFIKATSUCHE _ _ _ #15.04.2002, 18:00 Uhr#
CAPICOM _ CERTIFICATE _ FIND _ KEY _ USAGE NUR _ CAPICOM-ENCIPHER-SCHLÜSSELVERWENDUNG _ _ _

Anforderungen

Anforderung Wert
Ende des Supports (Client)
Windows Vista
Ende des Supports (Server)
Windows Server 2008
Verteilbare Komponente
CAPICOM 2.0 oder höher auf Windows Server 2003 und Windows XP
DLL
Capicom.dll

Siehe auch

Zertifikate

_CAPICOM-OID