Fungsi CertEnumSubjectInSortedCTL (wincrypt.h)
Fungsi CertEnumSubjectInSortedCTL mengambil TrustedSubject pertama atau berikutnya dalam daftar kepercayaan sertifikat (CTL) yang diurutkan. CTL yang diurutkan adalah CTL yang dibuat dengan kumpulan CERT_CREATE_CONTEXT_SORTED_FLAG. Digunakan dalam perulangan, fungsi ini dapat mengambil secara berurutan semua TrustedSubjects dalam CTL yang diurutkan.
Sintaks
BOOL CertEnumSubjectInSortedCTL(
[in] PCCTL_CONTEXT pCtlContext,
[in, out] void **ppvNextSubject,
[out] PCRYPT_DER_BLOB pSubjectIdentifier,
[out] PCRYPT_DER_BLOB pEncodedAttributes
);
Parameter
[in] pCtlContext
Penunjuk ke struktur CTL_CONTEXT yang akan dicari.
[in, out] ppvNextSubject
Penunjuk ke alamat TrustedSubject terakhir yang ditemukan. Untuk memulai enumerasi, ppvNextSubject harus menunjuk ke pointer yang diatur ke NULL. Setelah kembali, pointer yang ditangani oleh ppvNextSubject diperbarui untuk menunjuk ke TrustedSubject berikutnya dalam urutan yang dikodekan.
[out] pSubjectIdentifier
Penunjuk ke struktur CRYPT_DER_BLOB , secara unik mengidentifikasi TrustedSubject. Informasi dalam struktur ini dapat berupa hash atau urutan byte unik apa pun.
[out] pEncodedAttributes
Penunjuk ke struktur CRYPT_DER_BLOB yang berisi jumlah byte dan penunjuk ke atribut yang dikodekan TrustedSubject.
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE, dengan ppvNextSubject diperbarui untuk menunjuk ke TrustedSubject berikutnya dalam urutan yang dikodekan.
Jika fungsi gagal, nilai yang dikembalikan adalah FALSE. Nilai yang dikembalikan adalah FALSE jika tidak ada lagi subjek atau ada argumen yang tidak valid.
Keterangan
Anggota pbData dari struktur CRYPT_DER_BLOB menunjuk langsung ke byte yang dikodekan. Struktur CRYPT_DER_BLOB , sendiri, harus dialokasikan dan dibebaskan oleh aplikasi, tetapi memori yang ditangani oleh anggota pbData dari struktur ini tidak dialokasikan oleh aplikasi dan tidak boleh dibebaskan oleh aplikasi.
Jika CTL tidak diurutkan dengan set bendera CERT_CREATE_CONTEXT_SORTED_FLAG, hasil kesalahan.
Persyaratan
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | wincrypt.h |
| Pustaka | Crypt32.lib |
| DLL | Crypt32.dll |