Metode Store.Open

[Metode Buka 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 Buka membuka penyimpanan sertifikat tertentu. Secara default, lokasi CAPICOM_CURRENT_USER_STORE dan penyimpanan CAPICOM_MY_STORE dibuka sebagai baca-saja.

Sintaks

Store.Open( _
  [ ByVal StoreLocation ], _
  [ ByVal StoreName ], _
  [ ByVal OpenMode ] _
)

Parameter

StoreLocation [in, opsional]

Nilai enumerasi CAPICOM_STORE_LOCATION yang menunjukkan lokasi toko yang akan dibuka. Nilai defaultnya adalah CAPICOM_CURRENT_USER_STORE. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
CAPICOM_ACTIVE_DIRECTORY_USER_STORE	Penyimpanan adalah penyimpanan Direktori Aktif. Tidak ada kesalahan yang akan dihasilkan jika penyimpanan Direktori Aktif dibuka sebagai baca/tulis, tetapi perubahan apa pun pada penyimpanan tidak akan dipertahankan. Sertifikat tidak dapat ditambahkan atau dihapus dari penyimpanan Direktori Aktif.
CAPICOM_CURRENT_USER_STORE	Penyimpanan adalah penyimpanan pengguna saat ini. Penyimpanan pengguna saat ini mungkin merupakan penyimpanan baca/tulis. Jika ya, perubahan konten penyimpanan akan tetap ada.
CAPICOM_LOCAL_MACHINE_STORE	Toko ini adalah penyimpanan komputer lokal. Penyimpanan komputer lokal hanya dapat berupa penyimpanan baca/tulis jika pengguna memiliki izin baca/tulis. Jika pengguna memiliki izin baca/tulis dan jika penyimpanan dibuka baca/tulis, maka perubahan konten penyimpanan tetap ada.
CAPICOM_MEMORY_STORE	Penyimpanan adalah penyimpanan memori. Setiap perubahan dalam konten penyimpanan tidak dipertahankan.
CAPICOM_SMART_CARD_USER_STORE	Toko adalah grup kartu pintar saat ini. Diperkenalkan dalam CAPICOM 2.0.

 

StoreName [in, opsional]

String yang berisi nama penyimpanan sertifikat sistem yang akan dibuka. Nilai defaultnya adalah CAPICOM_MY_STORE. Jika penyimpanan dibuka dari skrip web, karakter garis miring terbelakang (\) tidak diperbolehkan dalam nama. Selain penyimpanan yang ditentukan oleh sistem, penyimpanan yang ditentukan pengguna dapat dibuka.

Parameter ini dapat menjadi penyimpanan yang ditentukan pengguna atau salah satu penyimpanan sertifikat sistem berikut.

Nilai	Makna
CAPICOM_CA_STORE	Penyimpanan CA. Penyimpanan ini digunakan untuk menyimpan sertifikat OS perantara.
CAPICOM_MY_STORE	Tokoku. Penyimpanan ini digunakan untuk sertifikat pribadi pengguna.
CAPICOM_OTHER_STORE	Penyimpanan AddressBook. Penyimpanan ini digunakan untuk menyimpan sertifikat orang lain.
CAPICOM_ROOT_STORE	Penyimpanan akar. Penyimpanan ini digunakan untuk menyimpan OS akar dan sertifikat tepercaya yang ditandatangani sendiri.

 

OpenMode [in, opsional]

Nilai enumerasi CAPICOM_STORE_OPEN_MODE yang menunjukkan mode buka penyimpanan. Nilai defaultnya adalah CAPICOM_STORE_OPEN_READ_ONLY. Jika penyimpanan dibuka dari skrip web, nilai ini dipaksa untuk CAPICOM_STORE_OPEN_EXISTING_ONLY. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
CAPICOM_STORE_OPEN_MAXIMUM_ALLOWED	Buka toko dalam mode baca/tulis jika pengguna memiliki izin baca/tulis; jika tidak, buka penyimpanan dalam mode baca-saja.
CAPICOM_STORE_OPEN_READ_ONLY	Buka penyimpanan dalam mode baca-saja.
CAPICOM_STORE_OPEN_READ_WRITE	Buka toko dalam mode baca/tulis.

 

Bendera berikut dapat dikombinasikan dengan nilai dalam tabel sebelumnya dengan menggunakan operasi logical-OR.

Nilai	Makna
CAPICOM_STORE_OPEN_EXISTING_ONLY	Buka toko yang ada saja; jangan membuat penyimpanan baru. Diperkenalkan dalam CAPICOM 2.0.
CAPICOM_STORE_OPEN_INCLUDE_ARCHIVED	Sertakan sertifikat yang diarsipkan saat menggunakan penyimpanan. Diperkenalkan dalam CAPICOM 2.0.

 

Penyimpanan di beberapa lokasi hanya dapat dibuka dalam mode baca-saja. Ini termasuk semua penyimpanan di CAPICOM_LOCAL_MACHINE_STORE yang penggunanya tidak memiliki izin menulis. Upaya untuk membuka penyimpanan sebagai penyimpanan baca/tulis tanpa akses dan izin yang tepat akan mengakibatkan kegagalan metode Buka . Penyimpanan Direktori Aktif dapat dibuka sebagai penyimpanan baca/tulis tanpa kegagalan metode Buka , tetapi perubahan pada penyimpanan tidak akan dipertahankan.

Nilai kembali

Metode ini tidak mengembalikan nilai.

Keterangan

Jika metode ini dipanggil pada penyimpanan SmartCard, antarmuka pengguna SmartCard tambahan dapat dipanggil.

Penting

Ketika metode ini dipanggil dari skrip web, skrip perlu mengakses sertifikat digital di komputer lokal. Jika Anda mengizinkan skrip untuk mengakses sertifikat digital Anda, situs web tempat skrip dijalankan juga akan mendapatkan akses ke informasi pribadi apa pun yang disimpan dalam sertifikat. Pertama kali metode ini dipanggil dari domain tertentu, kotak dialog dibuat di mana pengguna harus menunjukkan apakah akses ke sertifikat harus diizinkan. Penyimpanan yang dibuka dari skrip web secara otomatis memaksa bendera CAPICOM_STORE_OPEN_EXISTING_ONLY.

 

Jika StoreLocationCAPICOM_SMART_CARD_USER_STORE, StoreName diabaikan. Dalam hal ini, CAPICOM membaca semua sertifikat dari semua pembaca yang tersedia yang berisi kartu pintar.

Persyaratan

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

Lihat juga

Bursa

Objek Kriptografi

Tutup