CngKey.GetProperty(String, CngPropertyOptions) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u een eigenschap op, met een naam en een set eigenschappenopties.
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 CngPropertyParameters
- name
- String
De naam van de gewenste eigenschap.
- options
- CngPropertyOptions
Een bitsgewijze combinatie van de opsommingswaarden waarmee opties voor de benoemde eigenschap worden opgegeven.
Retouren
Een object dat de onbewerkte waarde van de opgegeven eigenschap bevat.
- Kenmerken
Uitzonderingen
name is null.
Alle andere fouten.
Opmerkingen
Het doel van deze methode is om de waarde van een willekeurige eigenschap van de sleutel te retourneren. De gebruikelijke manier om eigenschappen op te halen is door de eigenschapstoegangsors van de CngKey klasse te gebruiken. CngKey biedt wrappers voor verschillende, maar niet alle eigenschappen. De GetProperty methode wordt voornamelijk gebruikt voor toegang tot de waarde van een eigenschap die niet is verpakt.
Deze methode is handig in de volgende gevallen:
Een nieuwe versie van het besturingssysteem ondersteunt een nieuwe CNG-sleuteleigenschap (Cryptography Next Generation) die geen wrapper heeft.
U voegt een aangepaste eigenschap toe aan de sleutel.
De options parameter wordt specifiek gebruikt om het volgende aan te geven:
Of de eigenschap nu ingebouwd of aangepast is.
Of de eigenschap moet worden behouden met de sleutel.
Deze opties moeten overeenkomen met de waarde waarmee de eigenschap is ingesteld, of de eigenschap wordt niet gevonden.
CryptographicException wordt gegenereerd als de eigenschap niet kan worden gevonden. U moet de HasProperty methode eerst aanroepen om de uitzondering te voorkomen in plaats van de methode-aanroep in een try/catch blok te verpakken.
