Metode Store.Load

Artikel
06/13/2023

[Metode Pemuatan tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Sebagai gantinya, gunakan Kelas X509Store di dalam ruang nama System.Security.Cryptography.X509Certificates .]

Metode Muat mengimpor sertifikat dari file ke penyimpanan.

Sintaks

Store.Load( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal KeyStorageFlag ] _
)

Parameter

FileName [in]

String yang berisi jalur ke file .cer, .sst, .spc, .p7s, atau .pfx, atau file bertanda tangan Authenticode apa pun.

Kata sandi [in, opsional]

String yang berisi kata sandi teks biasa ke file. Hingga 32 karakter Unicode, termasuk karakter null yang mengakhiri, dapat digunakan untuk kata sandi. Untuk informasi tentang melindungi kata sandi, lihat Menangani Kata Sandi.

KeyStorageFlag [in, opsional]

Nilai enumerasi CAPICOM_KEY_STORAGE_FLAG yang menentukan bendera penyimpanan utama. Defaultnya adalah CAPICOM_KEY_STORAGE_DEFAULT. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
CAPICOM_KEY_STORAGE_DEFAULT	Penyimpanan kunci default.
CAPICOM_KEY_STORAGE_EXPORTABLE	Kunci dapat diekspor.
CAPICOM_KEY_STORAGE_USER_PROTECTED	Kunci dilindungi pengguna.

Nilai kembali

Metode ini tidak mengembalikan nilai.

Keterangan

Jika metode Muat dipanggil pada penyimpanan memori, kontainer kunci apa pun yang dibuat akan dihapus saat penyimpanan memori dihapus. Misalnya, jika file .pfx dimuat ke penyimpanan memori dan kemudian ditambahkan ke penyimpanan sistem (seperti Penyimpanan saya) dari penyimpanan memori, sertifikat di Penyimpanan saya tidak akan berisi kunci. Dalam hal ini, file .pfx harus dimuat langsung ke penyimpanan Saya.

Metode ini menaikkan CAPICOM_E_NOT_ALLOWED ketika ditulis dari aplikasi berbasis web.

Jika kata sandi gagal mendekripsi file kunci privat, maka penyedia layanan kriptografi default (CSP) harus dikueri. Jika CSP default adalah Penyedia Kriptografi Dasar Microsoft dan operasi dekripsi gagal, maka operasi dekripsi harus dicoba lagi dengan Penyedia Kriptografi Kuat Microsoft atau Penyedia Kriptografi yang Ditingkatkan Microsoft, mana pun yang tersedia.

Jika sertifikat yang dimuat ke penyimpanan sama dengan sertifikat yang sudah ada di sana, metode Muat akan menghapus sertifikat yang ada dari penyimpanan lalu menambahkan sertifikat baru. Sertifikat baru akan mewarisi properti dari sertifikat yang ada. Kontainer kunci privat yang ada digantikan oleh kontainer kunci privat baru.

Persyaratan

Persyaratan	Nilai
Redistribusi	CAPICOM 2.0 atau yang lebih baru di Windows Server 2003 dan Windows XP
DLL	Capicom.dll

Lihat juga

Bursa

Bagikan melalui