CngKey.GetProperty(String, CngPropertyOptions) Metodo

Definizione

Spazio dei nomi:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Source:

Cng.NotSupported.cs

Ottiene una proprietà, dato un nome e un insieme di opzioni della proprietà.

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);

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

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

Parametri

name

String

Nome della proprietà desiderata.

options

CngPropertyOptions

Combinazione bit per bit dei valori di enumerazione che specificano le opzioni per la proprietà denominata.

Restituisce

CngProperty

Oggetto contenente il valore non elaborato della proprietà specificata.

Eccezioni

ArgumentNullException

name è null.

CryptographicException

Tutti gli altri errori.

Commenti

Lo scopo di questo metodo consiste nel restituire il valore di una proprietà arbitraria della chiave. Il modo tipico per recuperare le proprietà consiste nell'usare CngKey le funzioni di accesso alle proprietà fornite dalla classe. CngKey fornisce wrapper per diversi, ma non tutti, proprietà. Il GetProperty metodo viene usato principalmente per accedere al valore di una proprietà che non viene eseguito il wrapping.

Questo metodo è utile nei casi seguenti:

• Una nuova versione del sistema operativo supporta una nuova proprietà di chiave Di nuova generazione di crittografia (CNG) che non ha un wrapper.

• Si aggiunge una proprietà personalizzata alla chiave.

Il options parametro viene usato specificamente per indicare quanto segue:

• Indipendentemente dal fatto che la proprietà sia predefinita o personalizzata.

• Indica se la proprietà deve essere mantenuta con la chiave.

Queste opzioni devono corrispondere al valore impostato con la proprietà oppure la proprietà non verrà trovata.

CryptographicException viene generato se la proprietà non può essere trovata. È necessario chiamare prima il HasProperty metodo per evitare l'eccezione anziché eseguire il wrapping della chiamata al metodo in un try/catch blocco.