Fungsi CertFindSubjectInCTL (wincrypt.h)

Artikel
08/27/2023

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
CTL_CERT_SUBJECT_TYPE	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 .
CTL_ANY_SUBJECT_TYPE	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
CRYPT_E_NOT_FOUND	Subjek tidak ditemukan di CTL.
E_INVALIDARG	Parameter dwSubjectType tidak CTL_CERT_SUBJECT_TYPE atau CTL_ANY_SUBJECT_TYPE.
NTE_BAD_ALGID	Anggota SubjectAlgorithm CTL tidak memetakan ke SHA1 atau MD5.

Keterangan

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

Lihat juga

Fungsi Pemeliharaan Penyimpanan Sertifikat dan Sertifikat