Fungsi WTHelperCertFindIssuerCertificate

  • Artikel

[Fungsi WTHelperCertFindIssuerCertificate tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Fungsi WTHelperCertFindIssuerCertificate menemukan sertifikat penerbit dari penyimpanan sertifikat yang ditentukan yang cocok dengan sertifikat subjek yang ditentukan.

Catatan

Fungsi ini tidak memiliki pustaka impor terkait. Anda harus menggunakan fungsi LoadLibrary dan GetProcAddress untuk menautkan secara dinamis ke Wintrust.dll.

 

Sintaks

PCCERT_CONTEXT WINAPI WTHelperCertFindIssuerCertificate(
  _In_      PCCERT_CONTEXT pChildContext,
  _In_      DWORD          chStores,
  _In_      HCERTSTORE     *pahStores,
  _In_      FILETIME       *psftVerifyAsOf,
  _In_      DWORD          dwEncoding,
  _Out_opt_ DWORD          *pdwConfidence,
  _Out_     DWORD          *dwError
);

Parameter

pChildContext [in]

Sertifikat subjek untuk menemukan sertifikat penerbit yang cocok.

chStores [in]

Jumlah elemen dalam array pahStores .

pahStores [in]

Array penyimpanan sertifikat untuk dicari.

psftVerifyAsOf [in]

Waktu verifikasi.

dwEncoding [in]

Nilai DWORD yang menentukan jenis pengodean sertifikat untuk diperiksa. Untuk informasi tentang kemungkinan jenis pengodean, lihat Jenis Pengodean Sertifikat dan Pesan.

pdwConfidence [out, opsional]

Parameter ini bisa menjadi kombinasi bit dari nol atau lebih dari nilai keyakinan berikut.

Nilai Makna
CERT_CONFIDENCE_SIG
0x10000000
 Tanda tangan sertifikat valid.
CERT_CONFIDENCE_TIME
0x01000000
 Waktu penerbit sertifikat valid.
CERT_CONFIDENCE_TIMENEST
0x00100000
 Waktu sertifikat valid.
CERT_CONFIDENCE_AUTHIDEXT
0x00010000
 Ekstensi ID otoritas valid.
CERT_CONFIDENCE_HYGIENE
0x00001000
 Minimal, tanda tangan sertifikat dan ekstensi ID otoritas valid.
CERT_CONFIDENCE_HIGHEST
0x11111000
 Kombinasi semua nilai keyakinan lainnya.

 

dwError [out]

Penunjuk ke variabel DWORD yang berisi nilai kesalahan untuk sertifikat ini, jika berlaku.

Nilai kembali

Sertifikat pengeluar sertifikat yang cocok dengan sertifikat subjek yang ditentukan oleh parameter pChildContext .

Keterangan

Agar berhasil menemukan sertifikat penerbit yang cocok, persyaratan berikut harus dipenuhi:

  • Tanda tangan sertifikat subjek yang ditentukan oleh parameter pChildContext harus valid.
  • Anggota rgExtension dari anggota pCertInfo dari parameter pChildContext harus berisi struktur CERT_AUTHORITY_KEY_ID_INFO . Anggota CertIssuer dan CertSerialMember dari struktur ini sangat cocok dengan anggota yang sesuai untuk sertifikat penerbit.
  • Nilai parameter psftVerifyAsOf harus dalam periode validitas sertifikat subjek.
  • Masa berlaku sertifikat subjek harus dalam jangka waktu validitas sertifikat penerbit.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows XP [hanya aplikasi desktop]
Server minimum yang didukung
 Windows Server 2003 [hanya aplikasi desktop]
DLL
Wintrust.dll