CngKey.GetProperty(String, CngPropertyOptions) Metoda

Definice

Obor názvů:

System.Security.Cryptography

Sestavení:

System.Security.Cryptography.dll

Zdroj:

Cng.NotSupported.cs

Získá vlastnost, která má název a sadu možností vlastnosti.

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);

member this.GetProperty : string * System.Security.Cryptography.CngPropertyOptions -> System.Security.Cryptography.CngProperty

Public Function GetProperty (name As String, options As CngPropertyOptions) As CngProperty

Parametry

name

String

Název požadované vlastnosti.

options

CngPropertyOptions

Bitové kombinace hodnot výčtu, které určují možnosti pro pojmenovanou vlastnost.

Návraty

CngProperty

Objekt, který obsahuje nezpracovanou hodnotu zadané vlastnosti.

Výjimky

ArgumentNullException

name je null.

CryptographicException

Všechny ostatní chyby.

Poznámky

Účelem této metody je vrátit hodnotu libovolné vlastnosti klíče. Typickým způsobem, jak načíst vlastnosti, je použití přístupových objektů vlastností poskytovaných CngKey třídou . CngKey poskytuje obálky pro několik vlastností, ale ne pro všechny. Metoda se GetProperty primárně používá pro přístup k hodnotě vlastnosti, která není zabalena.

Tato metoda je užitečná v následujících případech:

• Nová verze operačního systému podporuje novou vlastnost klíče CNG (Cryptography Next Generation), která nemá obálku.

• Ke klíči přidáte vlastní vlastnost.

Parametr options se používá konkrétně k označení následujícího:

• Určuje, jestli je vlastnost předdefinovaná nebo vlastní.

• Určuje, zda má být vlastnost trvale zachována s klíčem.

Tyto možnosti musí odpovídat hodnotě, se kterou byla vlastnost nastavena, jinak se vlastnost nenajde.

CryptographicException vyvolá se, pokud se vlastnost nenašla. Nejprve volejte metodu HasProperty , abyste se vyhnuli výjimce místo zabalení volání metody do try/catch bloku.