CngKey.GetProperty(String, CngPropertyOptions) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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);[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.CngPropertyPublic Function GetProperty (name As String, options As CngPropertyOptions) As CngPropertyParametri
- 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
Oggetto contenente il valore non elaborato della proprietà specificata.
- Attributi
Eccezioni
name è null.
Tutti gli altri errori.
Commenti
Lo scopo di questo metodo è restituire il valore di una proprietà arbitraria della chiave. Il modo tipico per recuperare le proprietà consiste nell'usare le funzioni di accesso alle CngKey proprietà fornite dalla classe . CngKey fornisce wrapper per diverse proprietà, ma non tutte. Il GetProperty metodo viene usato principalmente per accedere al valore di una proprietà che non è sottoposta a wrapping.
Questo metodo è utile nei casi seguenti:
Una nuova versione del sistema operativo supporta una nuova proprietà della chiave CNG (Cryptography Next Generation) che non dispone di un wrapper.
Si aggiunge una proprietà personalizzata alla chiave.
Il options parametro viene usato specificamente per indicare quanto segue:
Indica se la proprietà è predefinita o personalizzata.
Indica se la proprietà deve essere mantenuta con la chiave.
Queste opzioni devono corrispondere al valore con cui è stata impostata la proprietà oppure la proprietà non verrà trovata.
CryptographicException viene generata se non è possibile trovare la proprietà . È necessario chiamare prima il HasProperty metodo per evitare l'eccezione anziché eseguire il wrapping della chiamata al metodo in un try/catch blocco.
