struktur CTL_VERIFY_USAGE_STATUS (wincrypt.h)

Artikel
09/03/2024

Struktur CTL_VERIFY_USAGE_STATUS berisi informasi tentang Daftar Kepercayaan Sertifikat (CTL) yang dikembalikan oleh CertVerifyCTLUsage.

Sintaks

typedef struct _CTL_VERIFY_USAGE_STATUS {
  DWORD          cbSize;
  DWORD          dwError;
  DWORD          dwFlags;
  PCCTL_CONTEXT  *ppCtl;
  DWORD          dwCtlEntryIndex;
  PCCERT_CONTEXT *ppSigner;
  DWORD          dwSignerIndex;
} CTL_VERIFY_USAGE_STATUS, *PCTL_VERIFY_USAGE_STATUS;

Anggota

cbSize

Ukuran struktur dalam byte. Aplikasi yang memanggil CertVerifyCTLUsage mengatur parameter ini. Jika cbSize tidak lebih besar dari atau sama dengan ukuran struktur yang diperlukan, CertVerifyCTLUsage mengembalikan FALSE dan GetLastError mengembalikan E_INVALIDARG.

dwError

Status kesalahan, jika ada, dikembalikan oleh panggilan ke CertVerifyCTLUsage. Untuk daftar kemungkinan nilai kesalahan, lihat bagian Nilai Pengembalian di CertVerifyCTLUsage.

dwFlags

Jika CERT_VERIFY_UPDATED_CTL_FLAG dikembalikan, CertVerifyCTLUsage memperbarui CTL yang waktunya tidak lagi valid dengan CTL baru yang valid waktu.

ppCtl

Penunjuk ke penunjuk ke konteks CTL yang berisi subjek yang cocok. Aplikasi panggilan dapat mengatur pointer ini ke NULL untuk menunjukkan bahwa CTL yang berisi subjek tidak akan dikembalikan.

Jika ppCtl bukan NULL, aplikasi panggilan harus membebaskan konteks yang dikembalikan menggunakan CertFreeCTLContext.

dwCtlEntryIndex

Mengembalikan lokasi array entri subjek yang cocok dalam array CTL.

ppSigner

Penunjuk ke penunjuk ke konteks sertifikat penanda tangan CTL. Penunjuk ini dapat diatur ke NULL dengan aplikasi panggilan yang menunjukkan bahwa sertifikat penanda tangan CTL tidak akan dikembalikan.

Jika ppSigner bukan NULL, aplikasi panggilan harus membebaskan konteks yang dikembalikan menggunakan CertFreeCTLContext.

dwSignerIndex

Indeks penanda tangan benar-benar digunakan. Diperlukan jika pesan memiliki lebih dari satu penanda tangan.

Keterangan

Anggota dwError, dwFlags, dwCtlEntryIndex, dan dwSignerIndex harus diinisialisasi ke nol oleh aplikasi panggilan.

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

Lihat juga

CERT_CONTEXT

CTL_CONTEXT

CertVerifyCTLUsage

Bagikan melalui