struktur CTL_FIND_USAGE_PARA (wincrypt.h)
Struktur CTL_FIND_USAGE_PARA adalah anggota struktur CTL_FIND_SUBJECT_PARA dan digunakan oleh CertFindCTLInStore.
Sintaks
typedef struct _CTL_FIND_USAGE_PARA {
DWORD cbSize;
CTL_USAGE SubjectUsage;
CRYPT_DATA_BLOB ListIdentifier;
PCERT_INFO pSigner;
} CTL_FIND_USAGE_PARA, *PCTL_FIND_USAGE_PARA;
Anggota
cbSize
Ukuran, dalam byte, dari struktur ini.
SubjectUsage
CTL_USAGE struktur yang menyertakan urutan pengidentifikasi objek yang akan dicocokkan saat menemukan daftar kepercayaan sertifikat (CTL).
CTL yang ditemukan harus berisi semua pengidentifikasi objek penggunaan yang ditentukan oleh anggota SubjectUsage .
Jika anggota cUsageIdentifier struktur ini nol, CTL dengan penggunaan apa pun dapat cocok.
ListIdentifier
Ditentukan untuk membatasi pencarian ke daftar CTL penanda tangan tertentu. Biasanya anggota ListIdentifier akan nol, menunjukkan bahwa listIdentifier apa pun dapat dicocokkan. Jika bukan nol, ListIdentifier ini dan ListIdentifier dalam CTL harus cocok.
Untuk mencocokkan hanya CTL yang tidak memiliki ListIdentifier , anggota cbDatalistIdentifier diatur ke CTL_FIND_NO_LIST_ID_CBDATA.
CTL menggunakan ListIdentifier untuk membedakan di antara beberapa CTL yang dibuat oleh penerbit yang sama dengan SubjectUsage yang sama.
pSigner
Penunjuk ke struktur CERT_INFO yang menentukan penanda tangan CTL yang akan dicocokkan. Hanya penerbit dan nomor seri dari CERT_INFO yang digunakan untuk mencocokkan penanda tangan.
Atur pSigner ke NULL agar sesuai dengan penanda tangan apa pun. Untuk mencocokkan CTL yang tidak memiliki penanda tangan apa pun, atur pSigner ke CTL_FIND_NO_SIGNER_PTR.
CertEncodingType penanda tangan diperoleh dari parameter dwMsgAndCertEncodingType dari CertFindCTLInStore.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Header | wincrypt.h |