CngKey.GetProperty(String, CngPropertyOptions) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft eine Eigenschaft unter Angabe eines Namens und eines Satzes von Eigenschaftenoptionen ab.
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 CngPropertyParameter
- name
- String
Der Name der gewünschten Eigenschaft.
- options
- CngPropertyOptions
Eine bitweise Kombination der Enumerationswerte, die Optionen für die genannte Eigenschaft angeben.
Gibt zurück
Ein Objekt, das den Rohdatenwert der angegebenen Eigenschaft enthält.
- Attribute
Ausnahmen
name ist null.
Alle anderen Fehler.
Hinweise
Der Zweck dieser Methode besteht darin, den Wert einer beliebigen Eigenschaft des Schlüssels zurückzugeben. Die typische Methode zum Abrufen von Eigenschaften besteht darin, die von der CngKey -Klasse bereitgestellten Eigenschaftsaccessoren zu verwenden. CngKey stellt Wrapper für mehrere, aber nicht alle Eigenschaften bereit. Die GetProperty -Methode wird hauptsächlich verwendet, um auf den Wert einer Eigenschaft zuzugreifen, die nicht umschlossen ist.
Diese Methode ist in den folgenden Fällen nützlich:
Eine neue Version des Betriebssystems unterstützt eine neue CNG-Schlüsseleigenschaft (Cryptography Next Generation) ohne Wrapper.
Sie fügen dem Schlüssel eine benutzerdefinierte Eigenschaft hinzu.
Der options Parameter wird speziell verwendet, um Folgendes anzugeben:
Gibt an, ob die Eigenschaft integriert oder benutzerdefinierte Ist.
Gibt an, ob die Eigenschaft mit dem Schlüssel beibehalten werden soll.
Diese Optionen müssen mit dem Wert übereinstimmen, mit dem die Eigenschaft festgelegt wurde, sonst wird die Eigenschaft nicht gefunden.
CryptographicException wird ausgelöst, wenn die Eigenschaft nicht gefunden werden kann. Sie sollten zuerst die HasProperty -Methode aufrufen, um die Ausnahme zu vermeiden, anstatt den Methodenaufruf in einen Block einzuschließen try/catch .
