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.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
Oggetto contenente il valore non elaborato della proprietà specificata.
- Attributi
Eccezioni
name
è null
.
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.
Si applica a
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per