ICertificate2::Metode simpan

Artikel
06/12/2023

[CAPICOM adalah komponen 32-bit saja yang tersedia untuk digunakan dalam sistem operasi berikut: Windows Server 2008, Windows Vista, dan Windows XP. Sebagai gantinya, gunakan Kelas X509Certificate2 di dalam ruang nama System.Security.Cryptography.X509Certificates .]

Metode Simpan menyimpan sertifikat ke file. Metode ini diperkenalkan dalam CAPICOM 2.0.

Sintaks

Certificate.Save( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal SaveAs ], _
  [ ByVal IncludeOption ] _
)

Parameter

FileName [in]

String yang berisi nama file output tempat sertifikat akan disimpan.

Kata sandi [in, opsional]

String yang berisi kata sandi teks biasa untuk file kunci privat . Kata sandi dapat berisi hingga 32 karakter Unicode, termasuk karakter null yang dihentikan. Untuk informasi tentang melindungi kata sandi, lihat Menangani Kata Sandi.

SaveAs [in, opsional]

Nilai enumerasi CAPICOM_CERTIFICATE_SAVE_AS_TYPE yang menentukan format file output. Defaultnya adalah CAPICOM_CERTIFICATE_SAVE_AS_CER. Tabel berikut ini memperlihatkan nilai yang mungkin.

Nilai	Makna
CAPICOM_CERTIFICATE_SAVE_AS_CER	File output akan diformat sebagai file .cer tanpa kunci privat yang disimpan.
CAPICOM_CERTIFICATE_SAVE_AS_PFX	File output akan diformat sebagai file .pfx (PKCS #12) dan kunci privat terkait yang dapat diekspor juga akan disimpan.

IncludeOption [in, opsional]

Nilai enumerasi CAPICOM_CERTIFICATE_INCLUDE_OPTION yang menentukan berapa banyak sertifikat dalam rantai yang disimpan ke file output. Defaultnya adalah CAPICOM_CERTIFICATE_INCLUDE_END_ENTITY_ONLY. Tabel berikut ini memperlihatkan nilai yang mungkin.

Nilai	Makna
CAPICOM_CERTIFICATE_INCLUDE_CHAIN_EXCEPT_ROOT	Menyimpan semua sertifikat dalam rantai dengan pengecualian entitas akar
CAPICOM_CERTIFICATE_INCLUDE_WHOLE_CHAIN	Menyimpan rantai sertifikat lengkap
CAPICOM_CERTIFICATE_INCLUDE_END_ENTITY_ONLY	Hanya menyimpan sertifikat entitas akhir

Mengembalikan nilai

Metode ini tidak mengembalikan nilai.

Keterangan

Metode ini menaikkan CAPICOM_E_NOT_ALLOWED ketika ditulis dari aplikasi berbasis web.

Persyaratan

Persyaratan	Nilai
Akhir dukungan klien	Windows Vista
Akhir dukungan server	Windows Server 2008
Redistribusi	CAPICOM 2.0 atau yang lebih baru di Windows Server 2003 dan Windows XP
DLL	Capicom.dll