Freigeben über


CngKey.GetProperty(String, CngPropertyOptions) Methode

Definition

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.CngProperty
Public Function GetProperty (name As String, options As CngPropertyOptions) As CngProperty

Parameter

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 .

Gilt für: