Fungsi CertFindSubjectInCTL (wincrypt.h)
Fungsi CertFindSubjectInCTL mencoba menemukan subjek yang ditentukan dalam daftar kepercayaan sertifikat (CTL). Subjek dapat diidentifikasi baik oleh seluruh konteks sertifikat atau oleh pengidentifikasi unik subjek sertifikat seperti hash SHA1 dari penerbit sertifikat dan nomor seri.
Sintaks
PCTL_ENTRY CertFindSubjectInCTL(
[in] DWORD dwEncodingType,
[in] DWORD dwSubjectType,
[in] void *pvSubject,
[in] PCCTL_CONTEXT pCtlContext,
[in] DWORD dwFlags
);
Parameter
[in] dwEncodingType
Menentukan jenis pengodean yang digunakan. Saat ini, hanya X509_ASN_ENCODING dan PKCS_7_ASN_ENCODING yang digunakan; namun, jenis pengodean tambahan dapat ditambahkan di masa mendatang. Untuk salah satu jenis pengodean saat ini, gunakan:
X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.
[in] dwSubjectType
Menentukan jenis subjek yang akan dicari dalam CTL. Mungkin NULL untuk pencarian default.
Nilai | Makna |
---|---|
|
jenis data pvSubject: Penunjuk ke struktur CERT_CONTEXT.
SubjectAlgorithm CTL diperiksa untuk menentukan representasi identitas subjek. Awalnya, hanya hash SHA1 dan MD5 yang didukung sebagai nilai untuk SubjectAlgorithm. Properti hash yang sesuai diperoleh dari struktur CERT_CONTEXT . |
|
jenis data pvSubject: Penunjuk ke struktur CTL_ANY_SUBJECT_INFO.
Anggota SubjectAlgorithm dari struktur ini harus cocok dengan jenis algoritma CTL, dan anggota SubjectIdentifier harus cocok dengan salah satu entri CTL. |
Hash sertifikat atau anggota SubjectIdentifier dari struktur CTL_ANY_SUBJECT_INFO digunakan sebagai kunci dalam mencari entri subjek. Perbandingan memori biner dilakukan antara kunci dan SubjectIdentifier entri.
Jika dwSubjectType diatur ke nilai sebelumnya, dwEncodingType tidak digunakan.
[in] pvSubject
Pointer yang digunakan bersama dengan parameter dwSubjectType .
[in] pCtlContext
Penunjuk ke struktur CTL_CONTEXT sedang dicari.
[in] dwFlags
Dicadangkan untuk digunakan di masa mendatang dan harus nol.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah entri, jika ditemukan.
Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk informasi kesalahan yang diperluas, hubungi GetLastError. Beberapa kemungkinan kode kesalahan mengikuti.
Menampilkan kode | Deskripsi |
---|---|
|
Subjek tidak ditemukan di CTL. |
|
Parameter dwSubjectType tidak CTL_CERT_SUBJECT_TYPE atau CTL_ANY_SUBJECT_TYPE. |
|
Anggota SubjectAlgorithm CTL tidak memetakan ke SHA1 atau MD5. |
Keterangan
Hash sertifikat atau anggota SubjectIdentifier dari struktur CTL_ANY_SUBJECT_INFO digunakan sebagai kunci dalam mencari entri subjek. Perbandingan memori biner dilakukan antara kunci dan SubjectIdentifier entri.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | wincrypt.h |
Pustaka | Crypt32.lib |
DLL | Crypt32.dll |