ICertificates2::Temukan metode
[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 |
|
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk