Fungsi CertSerializeCertificateStoreElement (wincrypt.h)

Artikel
08/27/2023

Fungsi CertSerializeCertificateStoreElement menserialisasikan sertifikat yang dikodekan konteks sertifikat dan properti yang dikodekan. Hasilnya dapat disimpan ke penyimpanan sehingga sertifikat dan properti dapat diambil di lain waktu.

Sintaks

BOOL CertSerializeCertificateStoreElement(
  [in]      PCCERT_CONTEXT pCertContext,
  [in]      DWORD          dwFlags,
  [out]     BYTE           *pbElement,
  [in, out] DWORD          *pcbElement
);

Parameter

[in] pCertContext

Penunjuk ke CERT_CONTEXT yang akan diserialisasikan.

[in] dwFlags

Dicadangkan untuk digunakan di masa mendatang dan harus nol.

[out] pbElement

Penunjuk ke buffer yang menerima output berseri, termasuk sertifikat yang dikodekan dan mungkin propertinya.

Parameter ini dapat berupa NULL untuk mengatur ukuran informasi ini untuk tujuan alokasi memori. Untuk informasi selengkapnya, lihat Mengambil Data Dengan Panjang Tidak Diketahui.

[in, out] pcbElement

Penunjuk ke nilai DWORD yang menentukan ukuran, dalam byte, dari buffer yang ditunjukkan oleh parameter pbElement . Saat fungsi kembali, nilai DWORD berisi jumlah byte yang disimpan dalam buffer.

Catatan Saat memproses data yang dikembalikan dalam buffer, aplikasi harus menggunakan ukuran aktual data yang dikembalikan. Ukuran aktual bisa sedikit lebih kecil dari ukuran buffer yang ditentukan pada input. (Pada input, ukuran buffer biasanya ditentukan cukup besar untuk memastikan bahwa data output terbesar yang mungkin cocok di buffer.) Pada output, variabel yang diacu oleh parameter ini diperbarui untuk mencerminkan ukuran aktual data yang disalin ke buffer.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.

Jika fungsi gagal, nilai yang dikembalikan adalah FALSE. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

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

CertAddSerializedElementToStore

Fungsi Sertifikat

Bagikan melalui