Metode PrivateKey.Open

Artikel
06/13/2023

[Metode Buka tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Sebagai gantinya, gunakan Properti X509Certificate2.PrivateKey dalam namespace Layanan System.Security.Cryptography.X509Certificates .]

Metode Buka mengakses kontainer kunci yang ada. Metode ini mengaitkan kontainer kunci ke sertifikat yang sesuai dengan kunci privat dengan menambahkan properti CERT_KEY_PROV_INFO_PROP_ID menggunakan informasi yang ditentukan.

Sintaks

PrivateKey.Open( _
  ByVal ContainerName, _
  [ ByVal ProviderName ], _
  [ ByVal ProviderType ], _
  [ ByVal KeySpec ], _
  [ ByVal StoreLocation ], _
  [ ByVal bCheckExistence ] _
)

Parameter

ContainerName [in]

String yang berisi nama kontainer kunci.

ProviderName [in, opsional]

String yang berisi nama penyedia. Nilai defaultnya adalah CAPICOM_PROV_MS_ENHANCED_PROV. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
CAPICOM_PROV_MS_DEF_PROV	Penyedia kriptografi dasar Microsoft.
CAPICOM_PROV_MS_ENHANCED_PROV	Penyedia kriptografi microsoft yang disempurnakan.
CAPICOM_PROV_MS_STRONG_PROV	Penyedia kriptografi microsoft yang kuat.
CAPICOM_PROV_MS_DEF_RSA_SIG_PROV	Penyedia kriptografi tanda tangan Microsoft RSA.
CAPICOM_PROV_MS_DEF_RSA_SCHANNEL_PROV	Penyedia kriptografi Microsoft RSA Schannel.
CAPICOM_PROV_MS_DEF_DSS_PROV	Penyedia kriptografi DSS dasar Microsoft.
CAPICOM_PROV_MS_DEF_DSS_DH_PROV	DSS dasar Microsoft dan penyedia kriptografi Diffie-Hellman.
CAPICOM_PROV_MS_ENH_DSS_DH_PROV	Microsoft meningkatkan DSS dan Diffie-Hellman penyedia kriptografi.
CAPICOM_PROV_MS_DEF_DH_SCHANNEL_PROV	Penyedia kriptografi Microsoft DH Schannel.
CAPICOM_PROV_MS_SCARD_PROV	Penyedia kriptografi kartu pintar dasar Microsoft.
CAPICOM_PROV_MS_ENH_RSA_AES_PROV	Penyedia kriptografi RSA dan AES yang disempurnakan Microsoft.

ProviderType [in, opsional]

Nilai enumerasi CAPICOM_PROV_TYPE yang menentukan jenis penyedia. Nilai defaultnya adalah CAPICOM_PROV_RSA_FULL. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
CAPICOM_PROV_RSA_FULL	Penyedia layanan kriptografi (CSP) RSA lengkap. Jenis penyedia ini mendukung tanda tangan digital dan enkripsi data.
CAPICOM_PROV_RSA_SIG	Subset CSP RSA yang hanya mendukung fungsi dan algoritma yang diperlukan untuk hash dan tanda tangan digital.
CAPICOM_PROV_DSS	CSP Standar Tanda Tangan Digital (DSS). Jenis penyedia ini hanya mendukung hash dan tanda tangan digital. DSS menggunakan Algoritma Tanda Tangan Digital (DSA).
CAPICOM_PROV_FORTEZZA	CSP yang berisi protokol dan algoritma kriptografi yang dimiliki oleh National Institute of Standards and Technology (NIST).
CAPICOM_PROV_MS_EXCHANGE	CSP yang mendukung aplikasi email Microsoft Exchange dan aplikasi lain yang kompatibel dengan Microsoft Mail.
CAPICOM_PROV_SSL	CSP yang mendukung protokol Secure Sockets Layer (SSL).
CAPICOM_PROV_RSA_SCHANNEL	CSP yang mendukung protokol RSA dan Schannel .
CAPICOM_PROV_DSS_DH	CSP yang mendukung protokol DSS dan Diffie-Hellman .
CAPICOM_PROV_EC_ECDSA_SIG	CSP yang mendukung fungsi dan algoritma Elliptic Curve Digital Signature Algorithm (ECDSA) yang diperlukan untuk tanda tangan digital.
CAPICOM_PROV_EC_ECNRA_SIG	CSP yang mendukung fungsi dan algoritma Elliptic Curve Nyberg-Rueppel Analog (ECNRA) yang diperlukan untuk tanda tangan digital.
CAPICOM_PROV_EC_ECDSA_FULL	CSP yang mendukung ECDSA penuh.
CAPICOM_PROV_EC_ECNRA_FULL	CSP yang mendukung ECNRA penuh.
CAPICOM_PROV_DH_SCHANNEL	CSP yang mendukung protokol Diffie-Hellman dan Schannel .
CAPICOM_PROV_SPYRUS_LYNKS	CSP yang mendukung perangkat Kartu SPYRUS LYNKS.
CAPICOM_PROV_RNG	CSP yang menangani pembuatan angka acak.
CAPICOM_PROV_INTEL_SEC	CSP yang menyediakan keamanan Intel.
CAPICOM_PROV_REPLACE_OWF	CSP yang mendukung penggantian cara di mana format satu arah dihasilkan dari kata sandi.
CAPICOM_PROV_RSA_AES	CSP yang mendukung tanda tangan digital dan enkripsi data menggunakan algoritma Standar Enkripsi Lanjutan (AES).

KeySpec [in, opsional]

Nilai enumerasi CAPICOM_KEY_SPEC yang menentukan jenis kunci privat. Nilai defaultnya adalah CAPICOM_KEY_SPEC_SIGNATURE. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
CAPICOM_KEY_SPEC_KEYEXCHANGE	Kunci dapat digunakan untuk enkripsi dan penandatanganan.
CAPICOM_KEY_SPEC_SIGNATURE	Kunci hanya dapat digunakan untuk penandatanganan.

StoreLocation [in, opsional]

Nilai enumerasi CAPICOM_STORE_LOCATION yang menentukan lokasi penyimpanan tempat kunci berada. Nilai defaultnya adalah CAPICOM_CURRENT_USER_STORE. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
CAPICOM_MEMORY_STORE	Penyimpanan adalah penyimpanan memori. Setiap perubahan dalam isi penyimpanan tidak dipertahankan.
CAPICOM_LOCAL_MACHINE_STORE	Toko ini adalah penyimpanan komputer lokal. Penyimpanan komputer lokal dapat berupa penyimpanan baca/tulis hanya jika pengguna memiliki izin baca/tulis. Jika pengguna memiliki izin baca/tulis dan jika penyimpanan dibuka baca/tulis, maka perubahan isi toko akan tetap ada.
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_ACTIVE_DIRECTORY_USER_STORE	Penyimpanan adalah penyimpanan Direktori Aktif. Penyimpanan Direktori Aktif hanya dapat dibuka dalam mode baca-saja. Sertifikat tidak dapat ditambahkan ke atau dihapus dari penyimpanan Direktori Aktif.
CAPICOM_SMART_CARD_USER_STORE	Toko adalah grup kartu pintar saat ini. Diperkenalkan di CAPICOM 2.0.

bCheckExistence [in, opsional]

Nilai Boolean yang menunjukkan apakah CAPICOM akan mencoba mengakses kunci. Jika True, CAPICOM mencoba mengakses kunci. Jika kunci dilindungi pengguna atau pada kartu pintar atau perangkat lain, kotak dialog dapat dibuat. Nilai defaultnya adalah False.

Mengembalikan nilai

Metode ini tidak mengembalikan nilai.

Keterangan

Metode ini mengembalikan CAPICOM_E_NOT_ALLOWED ketika ditulis dari aplikasi berbasis web.

Persyaratan

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

Lihat juga

PrivateKey
Certificate.HasPrivateKey