CngKey.GetProperty(String, CngPropertyOptions) Methode

Referenz

Definition

Namespace:: System.Security.Cryptography

Assembly:: System.Security.Cryptography.Cng.dll

Assembly:: System.Security.Cryptography.dll

Assembly:: System.Core.dll

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

Quelle:: Cng.NotSupported.cs

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.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

CngProperty

Ein Objekt, das den Rohdatenwert der angegebenen Eigenschaft enthält.

Attribute: SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

name ist null.

CryptographicException

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 Eigenschaftenaccessoren 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), die keinen Wrapper aufweist.
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 benutzerdefiniert 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, andernfalls 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: