CngKey.GetProperty(String, CngPropertyOptions) Metode

Referensi

Definisi

Ruang nama:: System.Security.Cryptography

Rakitan:: System.Security.Cryptography.Cng.dll

Rakitan:: System.Security.Cryptography.dll

Rakitan:: System.Core.dll

Paket:: System.Security.Cryptography.Cng v5.0.0

Sumber:: Cng.NotSupported.cs

Sumber:: Cng.NotSupported.cs

Sumber:: Cng.NotSupported.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan properti, diberi nama dan sekumpulan opsi properti.

public:
 System::Security::Cryptography::CngProperty GetProperty(System::String ^ name, System::Security::Cryptography::CngPropertyOptions options);

public System.Security.Cryptography.CngProperty GetProperty (string name, System.Security.Cryptography.CngPropertyOptions options);

[System.Security.SecurityCritical]
public System.Security.Cryptography.CngProperty GetProperty (string name, System.Security.Cryptography.CngPropertyOptions options);

member this.GetProperty : string * System.Security.Cryptography.CngPropertyOptions -> System.Security.Cryptography.CngProperty

[<System.Security.SecurityCritical>]
member this.GetProperty : string * System.Security.Cryptography.CngPropertyOptions -> System.Security.Cryptography.CngProperty

Public Function GetProperty (name As String, options As CngPropertyOptions) As CngProperty

Parameter

name: String

Nama properti yang diinginkan.

options: CngPropertyOptions

Kombinasi bitwise dari nilai enumerasi yang menentukan opsi untuk properti bernama.

Mengembalikan

CngProperty

Objek yang berisi nilai mentah properti yang ditentukan.

Atribut: SecurityCriticalAttribute

Pengecualian

ArgumentNullException

nameadalah null.

CryptographicException

Semua kesalahan lainnya.

Keterangan

Tujuan dari metode ini adalah untuk mengembalikan nilai properti arbitrer kunci. Cara umum untuk mengambil properti adalah dengan menggunakan pengaktor properti yang disediakan oleh CngKey kelas . CngKey menyediakan pembungkus untuk beberapa properti, tetapi tidak semua. Metode GetProperty ini terutama digunakan untuk mengakses nilai properti yang tidak dibungkus.

Metode ini berguna dalam kasus-kasus berikut:

Versi baru sistem operasi mendukung properti kunci Cryptography Next Generation (CNG) baru yang tidak memiliki pembungkus.
Anda menambahkan properti kustom ke kunci.

Parameter options ini secara khusus digunakan untuk menunjukkan hal-hal berikut:

Apakah properti bawaan, atau kustom.
Apakah properti harus dipertahankan dengan kunci.

Opsi ini harus cocok dengan nilai yang diatur properti, atau properti tidak akan ditemukan.

CryptographicException dilemparkan jika properti tidak dapat ditemukan. Anda harus memanggil metode terlebih HasProperty dahulu untuk menghindari pengecualian alih-alih membungkus panggilan metode dalam try/catch blok.

Berlaku untuk

Bagikan melalui