CertCreateCTLEntryFromCertificateContextProperties (wincrypt.h)

Fungsi CertCreateCTLEntryFromCertificateContextProperties membuat entri daftar kepercayaan sertifikat (CTL) yang atributnya adalah properti konteks sertifikat. SubjectIdentifier dalam entri CTL adalah hash SHA1 dari sertifikat.

Properti sertifikat ditambahkan sebagai atribut. Atribut properti OID adalah PROP_ID desimal yang didahului oleh szOID_CERT_PROP_ID_PREFIX. Setiap nilai properti disalin sebagai nilai atribut tunggal.

Atribut tambahan dapat disertakan dalam entri CTL dengan menggunakan parameter cOptAttr dan rgOptAttr .

Sintaks

BOOL CertCreateCTLEntryFromCertificateContextProperties(
  [in]      PCCERT_CONTEXT   pCertContext,
  [in]      DWORD            cOptAttr,
  [in]      PCRYPT_ATTRIBUTE rgOptAttr,
  [in]      DWORD            dwFlags,
  [in]      void             *pvReserved,
  [out]     PCTL_ENTRY       pCtlEntry,
  [in, out] DWORD            *pcbCtlEntry
);

Parameter

[in] pCertContext

Penunjuk ke CERT_CONTEXT digunakan untuk membuat CTL.

[in] cOptAttr

DWORD yang menentukan jumlah atribut tambahan yang akan ditambahkan.

[in] rgOptAttr

Penunjuk ke array atribut CRYPT_ATTRIBUTE apa pun yang akan ditambahkan ke CTL.

[in] dwFlags

SEBUAH DWORD. Dapat diatur ke CTL_ENTRY_FROM_PROP_CHAIN_FLAG untuk memaksa penyertaan properti hash pembangunan rantai sebagai atribut.

[in] pvReserved

Penunjuk ke VOID. Disiapkan untuk penggunaan masa mendatang.

[out] pCtlEntry

Alamat penunjuk ke struktur CTL_ENTRY . Panggil fungsi ini dua kali untuk mengambil entri CTL. Atur parameter ini ke NULL pada panggilan pertama. Saat fungsi kembali, gunakan jumlah byte yang diambil dari parameter pcbCtlEntry untuk mengalokasikan memori. Panggil fungsi lagi, atur parameter ini ke alamat memori yang dialokasikan.

[in, out] pcbCtlEntry

Penunjuk ke DWORD yang berisi jumlah byte yang harus dialokasikan untuk struktur CTL_ENTRY . Panggil fungsi ini dua kali untuk mengambil jumlah byte. Untuk panggilan pertama, atur parameter ini ke alamat nilai DWORD yang berisi nol dan atur parameter pCtlEntry ke NULL. Jika panggilan pertama berhasil, nilai DWORD akan berisi jumlah byte yang harus Anda alokasikan untuk struktur CTL_ENTRY . Alokasikan memori yang diperlukan dan panggil fungsi lagi, menyediakan alamat memori dalam parameter pCtlEntry .

Nilai kembali

Jika fungsi berhasil, fungsi mengembalikan bukan nol (TRUE).

Jika fungsi gagal, fungsi mengembalikan nol (FALSE). Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan

Persyaratan	Nilai
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