Fungsi CertEnumCertificateContextProperties (wincrypt.h)

Fungsi CertEnumCertificateContextProperties mengambil properti perluasan pertama atau berikutnya yang terkait dengan konteks sertifikat. Digunakan dalam perulangan, fungsi ini dapat mengambil secara berurutan semua properti yang diperluas yang terkait dengan konteks sertifikat.

Sintaks

DWORD CertEnumCertificateContextProperties(
  [in] PCCERT_CONTEXT pCertContext,
  [in] DWORD          dwPropId
);

Parameter

[in] pCertContext

Penunjuk ke struktur CERT_CONTEXT sertifikat yang berisi properti yang akan dijumlahkan.

[in] dwPropId

Nomor properti dari properti terakhir yang dijumlahkan. Untuk mendapatkan properti pertama, dwPropId adalah nol. Untuk mengambil properti berikutnya, dwPropId diatur ke nomor properti yang dikembalikan oleh panggilan terakhir ke fungsi. Untuk menghitung semua properti, panggilan fungsi berlanjut hingga fungsi mengembalikan nol.

Aplikasi dapat memanggil CertGetCertificateContextProperty dengan dwPropId yang dikembalikan oleh fungsi ini untuk mengambil data properti tersebut.

Nilai kembali

Nilai yang dikembalikan adalah nilai DWORD yang mengidentifikasi properti konteks sertifikat . Nilai DWORD yang dikembalikan oleh satu panggilan fungsi dapat disediakan sebagai dwPropId dalam panggilan berikutnya ke fungsi. Jika tidak ada lagi properti yang akan dijumlahkan atau jika fungsi gagal, nol akan dikembalikan.

Keterangan

properti CERT_KEY_PROV_HANDLE_PROP_ID dan CERT_KEY_SPEC_PROP_ID disimpan sebagai anggota properti CERT_KEY_CONTEXT_PROP_ID. Mereka tidak dijumlahkan secara individual.

Contoh

Lihat Contoh Program C: Mencantumkan Sertifikat di Toko.

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

CERT_CONTEXT

CertGetCertificateContextProperty

Fungsi Properti yang Diperluas