Fungsi CertSelectionGetSerializedBlob (cryptuiapi.h)

Artikel
08/22/2023

Fungsi CertSelectionGetSerializedBlob adalah fungsi pembantu yang digunakan untuk mengambil BLOB sertifikat berseri dari struktur CERT_SELECTUI_INPUT .

Sintaks

HRESULT CertSelectionGetSerializedBlob(
  [in]  PCERT_SELECTUI_INPUT pcsi,
  [out] void                 **ppOutBuffer,
  [out] ULONG                *pulOutBufferSize
);

Parameter

[in] pcsi

Penunjuk ke struktur CERT_SELECTUI_INPUT yang berisi penyimpanan sertifikat dan informasi rantai konteks sertifikat.

[out] ppOutBuffer

Alamat penunjuk ke buffer yang menerima BLOB sertifikat berseri.

[out] pulOutBufferSize

Penunjuk ke ULONG untuk menerima ukuran, dalam byte, dari BLOB yang diterima dalam buffer yang ditujukkan oleh parameter ppOutBuffer .

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Jika parameter hStore dan prgpChain bukan NULL, kembalikan E_INVALIDARG. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Keterangan

BLOB serial yang dikembalikan diteruskan ke fungsi CredUIPromptForWindowsCredentials dalam parameter pvInAuthBuffer untuk memungkinkan pengguna memilih sertifikat dengan menggunakan UI pemilihan kredensial.

Sertifikat yang diserialisasikan dalam BLOB yang dikembalikan dalam buffer yang ditunjukkan oleh parameter ppOutBuffer dari fungsi ini tergantung pada nilai anggota hStore dan prgpChain dari struktur CERT_SELECTUI_INPUT .

hStore	prgpChain	Sertifikat yang diserialisasikan
NULL	bukan NULL	Sertifikat yang ditunjukkan oleh anggota prgpChain diserialisasikan.
bukan NULL	NULL	Sertifikat yang ditentukan oleh anggota hStore diserialisasikan.
NULL	NULL	BLOB kosong dikembalikan.
bukan NULL	bukan NULL	Panggilan gagal dan fungsi mengembalikan E_INVALIDARG.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	cryptuiapi.h
DLL	Cryptui.dll

Bagikan melalui