Bagikan melalui

ICertificates2::Temukan metode

  • Artikel

[CAPICOM adalah komponen 32-bit saja yang tersedia untuk digunakan dalam sistem operasi berikut: Windows Server 2008, Windows Vista, dan Windows XP. Sebagai gantinya, gunakan Kelas X509Certificate2Collection di dalam ruang nama System.Security.Cryptography.X509Certificates .]

Metode Temukan mengembalikan objek Sertifikat yang berisi semua sertifikat yang cocok dengan kriteria pencarian yang ditentukan. Metode ini diperkenalkan dalam CAPICOM 2.0.

Sintaks

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

Parameter

FindType [in]

Nilai enumerasi CAPICOM_CERTIFICATE_FIND_TYPE yang menentukan jenis kriteria pencocokan yang disediakan dalam parameter varCriteria . Tabel berikut ini memperlihatkan nilai yang mungkin.

Nilai Makna
CAPICOM_CERTIFICATE_FIND_SHA1_HASH
 Mengembalikan sertifikat dengan hash SHA1 yang cocok dengan hash SHA1 yang ditentukan dalam parameter varCriteria .
CAPICOM_CERTIFICATE_FIND_SUBJECT_NAME
 Mengembalikan sertifikat yang nama subjeknya persis atau sebagian cocok dengan nama subjek yang ditentukan dalam parameter varCriteria . Panggilan ini hanya mencari bidang nama subjek.
CAPICOM_CERTIFICATE_FIND_ISSUER_NAME
 Mengembalikan sertifikat yang nama penerbitnya persis atau sebagian cocok dengan nama pengeluar sertifikat yang ditentukan dalam parameter varCriteria . Panggilan ini hanya mencari bidang nama pengeluar sertifikat.
CAPICOM_CERTIFICATE_FIND_ROOT_NAME
 Mengembalikan sertifikat yang nama subjek akarnya persis atau sebagian cocok dengan nama subjek akar yang ditentukan dalam parameter varCriteria . Panggilan ini membuat rantai. Panggilan ini mencari bidang nama subjek sertifikat akar.
CAPICOM_CERTIFICATE_FIND_TEMPLATE_NAME
 Mengembalikan sertifikat yang nama templatnya cocok dengan nama templat yang ditentukan dalam parameter varCriteria .
CAPICOM_CERTIFICATE_FIND_EXTENSION
 Mengembalikan sertifikat yang memiliki ekstensi yang cocok dengan ekstensi yang ditentukan dalam parameter varCriteria .
CAPICOM_CERTIFICATE_FIND_EXTENDED_PROPERTY
 Mengembalikan sertifikat di penyimpanan yang secara eksplisit berisi properti yang diperluas dengan nilai yang ditentukan dalam parameter varCriteria .
CAPICOM_CERTIFICATE_FIND_APPLICATION_POLICY
 Mengembalikan sertifikat di penyimpanan yang memiliki ekstensi penggunaan kunci yang ditingkatkan, ekstensi kebijakan aplikasi, atau properti yang diperluas yang ditentukan dalam parameter varCriteria .
CAPICOM_CERTIFICATE_FIND_CERTIFICATE_POLICY
 Mengembalikan sertifikat yang berisi OID kebijakan dalam ekstensi Kebijakan Sertifikat yang ditentukan dalam parameter varCriteria .
CAPICOM_CERTIFICATE_FIND_TIME_VALID
 Mengembalikan sertifikat yang waktunya valid.
CAPICOM_CERTIFICATE_FIND_TIME_NOT_YET_VALID
 Mengembalikan sertifikat yang waktunya belum valid.
CAPICOM_CERTIFICATE_FIND_TIME_EXPIRED
 Mengembalikan sertifikat yang waktunya telah kedaluwarsa.
CAPICOM_CERTIFICATE_FIND_KEY_USAGE
 Mengembalikan sertifikat yang berisi penggunaan kunci dalam ekstensi KeyUsage yang ditentukan dalam parameter varCriteria . Jika ekstensi KeyUsage tidak ada, semua penggunaan kunci diasumsikan tidak tersedia.

 

varCriteria [in, opsional]

Varian yang berisi kriteria pencarian. Data ini harus cocok dengan jenis data yang ditentukan dalam parameter FindType . Jika nilai parameter FindType CAPICOM_CERTIFICATE_FIND_TIME_VALID, CAPICOM_CERTIFICATE_FIND_TIME_NOT_YET_VALID, atau CAPICOM_CERTIFICATE_FIND_TIME_EXPIRED dan Anda tidak meneruskan nilai ke dalam parameter ini, waktu saat ini diasumsikan. Untuk contoh setiap jenis data, lihat Keterangan. Nilai default adalah 0.

bFindValidOnly [dalam, opsional]

Nilai Boolean yang menunjukkan apakah hanya sertifikat yang valid yang dikembalikan. Nilai defaultnya adalah false; ini menunjukkan bahwa semua sertifikat yang cocok dengan kriteria pencarian dikembalikan.

Jika true, pencarian tidak akan mengembalikan jenis sertifikat berikut:

  • Sertifikat yang waktunya telah kedaluwarsa atau belum valid.
  • Sertifikat tidak ditautkan dengan benar.
  • Sertifikat yang memiliki masalah tanda tangan.
  • Sertifikat yang dicabut.

Mengembalikan nilai

Objek sertifikat yang berisi hasil pencarian.

CAPICOM 2.1: Objek Sertifikat yang dikembalikan berisi referensi ke sertifikat dalam koleksi tempat pencarian dilakukan. Setiap perubahan yang dilakukan pada sertifikat dalam objek Sertifikat yang dikembalikan tercermin dalam koleksi tersebut.

CAPICOM 2.0, CAPICOM 2.0.0.1, CAPICOM 2.0.0.2, dan CAPICOM 2.0.0.3: Objek Sertifikat yang dikembalikan berisi salinan sertifikat dalam koleksi tempat pencarian dilakukan. Setiap perubahan yang dilakukan pada sertifikat dalam objek Sertifikat yang dikembalikan tidak tercermin dalam koleksi tersebut.

Keterangan

Contoh berikut menunjukkan kemungkinan kriteria pencarian untuk berbagai jenis kriteria pencarian.

Parameter FindType parameter varCriteria
CAPICOM_CERTIFICATE_FIND_SHA1_HASH 33F362434B577F844BB7226BE36F7D72EF9D9393
CAPICOM_CERTIFICATE_FIND_SUBJECT_NAME "NameOfPerson"
CAPICOM_CERTIFICATE_FIND_ISSUER_NAME "VeriSign"
CAPICOM_CERTIFICATE_FIND_ROOT_NAME "Otoritas Akar Microsoft"
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
"Daftar Distribusi CRL"
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
"Penandatanganan Kode"
CAPICOM_CERTIFICATE_FIND_CERTIFICATE_POLICY "1.3.6.1.5.5.7.3.4.3.5"
"Jaminan Tinggi Perusahaan"
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

 

Persyaratan

Persyaratan Nilai
Akhir dukungan klien
 Windows Vista
Akhir dukungan server
 Windows Server 2008
Redistributable
 CAPICOM 2.0 atau yang lebih baru di Windows Server 2003 dan Windows XP
DLL
Capicom.dll

Lihat juga

Sertifikat

CAPICOM_OID