Bagikan melalui

Fungsi CertSaveStore (wincrypt.h)

  • Artikel

Fungsi CertSaveStore menyimpan penyimpanan sertifikat ke file atau ke BLOB memori.

Sintaks

BOOL CertSaveStore(
  [in]      HCERTSTORE hCertStore,
  [in]      DWORD      dwEncodingType,
  [in]      DWORD      dwSaveAs,
  [in]      DWORD      dwSaveTo,
  [in, out] void       *pvSaveToPara,
  [in]      DWORD      dwFlags
);

Parameter

[in] hCertStore

Handel penyimpanan sertifikat yang akan disimpan.

[in] dwEncodingType

Menentukan jenis pengodean sertifikat dan jenis pengodean pesan. Pengodean hanya digunakan ketika dwSaveAs berisi CERT_STORE_SAVE_AS_PKCS7. Jika tidak, parameter dwMsgAndCertEncodingType tidak digunakan.

Parameter ini bisa menjadi kombinasi dari satu atau beberapa nilai berikut.

Nilai Makna
PKCS_7_ASN_ENCODING
65536 (0x10000)
 Menentukan pengodean pesan PKCS 7.
X509_ASN_ENCODING
1 (0x1)
 Menentukan pengodean sertifikat X.509.

[in] dwSaveAs

Menentukan cara menyimpan penyimpanan sertifikat.

Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
CERT_STORE_SAVE_AS_PKCS7
2
 Penyimpanan sertifikat dapat disimpan sebagai pesan bertanda tangan PKCS #7 yang tidak menyertakan properti tambahan. Parameter dwEncodingType menentukan jenis pengodean pesan.
CERT_STORE_SAVE_AS_STORE
1
 Penyimpanan sertifikat dapat disimpan sebagai penyimpanan serial yang berisi properti selain sertifikat yang dikodekan, daftar pencabutan sertifikat (CRL), dan daftar kepercayaan sertifikat (CCL). Parameter dwEncodingType diabaikan.
Catatan Properti CERT_KEY_CONTEXT_PROP_ID dan nilai CERT_KEY_PROV_HANDLE_PROP_ID dan CERT_KEY_SPEC_PROP_ID terkait tidak disimpan ke penyimpanan berseri.
 

[in] dwSaveTo

Menentukan tempat dan cara menyimpan penyimpanan sertifikat. Konten parameter ini menentukan format parameter pvSaveToPara .

Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
CERT_STORE_SAVE_TO_FILE
1
 Fungsi menyimpan penyimpanan sertifikat ke file. Parameter pvSaveToPara berisi handel ke file yang sebelumnya diperoleh dengan menggunakan fungsi CreateFile . File harus dibuka dengan izin tulis. Setelah operasi penyimpanan berhasil, penunjuk file diposisikan setelah operasi penulisan terakhir.
CERT_STORE_SAVE_TO_FILENAME
4
 Fungsi menyimpan penyimpanan sertifikat ke file. Parameter pvSaveToPara berisi penunjuk ke string Unicode yang dihentikan null yang berisi jalur dan nama file file untuk disimpan. Fungsi membuka file, menyimpannya, dan menutupnya.
CERT_STORE_SAVE_TO_FILENAME_A
3
 Fungsi menyimpan penyimpanan sertifikat ke file. Parameter pvSaveToPara berisi penunjuk ke string ANSI yang dihentikan null yang berisi jalur dan nama file file untuk disimpan. Fungsi membuka file, menyimpannya, dan menutupnya.
CERT_STORE_SAVE_TO_FILENAME_W
4
 Fungsi menyimpan penyimpanan sertifikat ke file. Parameter pvSaveToPara berisi penunjuk ke string Unicode yang dihentikan null yang berisi jalur dan nama file file untuk disimpan. Fungsi membuka file, menyimpannya, dan menutupnya.
CERT_STORE_SAVE_TO_MEMORY
2
 Fungsi menyimpan penyimpanan sertifikat ke BLOB memori. Parameter pvSaveToPara berisi pointer ke struktur CERT_BLOB . Sebelum digunakan, anggota pbData dan cbDataCERT_BLOB harus diinisialisasi. Setelah kembali, cbData diperbarui dengan panjang aktual. Untuk perhitungan panjang-saja, pbData harus diatur ke NULL. Jika pbDatanon-NULL dan cbData tidak cukup besar, fungsi mengembalikan nol dengan kode kesalahan terakhir ERROR_MORE_DATA.

[in, out] pvSaveToPara

Penunjuk yang mewakili tempat penyimpanan harus disimpan. Konten parameter ini tergantung pada nilai parameter dwSaveTo .

[in] dwFlags

Parameter ini dicadangkan untuk digunakan di masa mendatang dan harus diatur ke nol.

Nilai kembali

Jika fungsi berhasil, fungsi mengembalikan bukan nol.

Jika fungsi gagal, fungsi akan mengembalikan nol. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Perhatikan bahwa kesalahan CreateFile atau WriteFile dapat disebarluaskan ke fungsi ini. Salah satu kemungkinan kode kesalahan adalah CRYPT_E_FILE_ERROR yang menunjukkan bahwa terjadi kesalahan saat menulis ke file.

Persyaratan

   
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

CertCloseStore

CertOpenStore

Fungsi Penyimpanan Sertifikat

CreateFile

WriteFile