CngKey.GetProperty(String, CngPropertyOptions) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Security.Cryptography

Zestaw:: System.Security.Cryptography.Cng.dll

Zestaw:: System.Security.Cryptography.dll

Zestaw:: System.Core.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera właściwość, nadaną nazwę i zestaw opcji właściwości.

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

Parametry

name: String

Nazwa żądanej właściwości.

options: CngPropertyOptions

Bitowa kombinacja wartości wyliczenia, które określają opcje dla nazwanej właściwości.

Zwraca

CngProperty

Obiekt, który zawiera nieprzetworzone wartości określonej właściwości.

Atrybuty: SecurityCriticalAttribute

Wyjątki

ArgumentNullException

name to null.

CryptographicException

Wszystkie inne błędy.

Uwagi

Celem tej metody jest zwrócenie wartości dowolnej właściwości klucza. Typowym sposobem pobierania właściwości jest użycie metod dostępu do właściwości dostarczonych przez klasę CngKey . CngKey zapewnia otoki dla kilku, ale nie wszystkich, właściwości. Metoda GetProperty jest używana głównie do uzyskiwania dostępu do wartości właściwości, która nie jest opakowana.

Ta metoda jest przydatna w następujących przypadkach:

Nowa wersja systemu operacyjnego obsługuje nową właściwość klucza Cryptography Next Generation (CNG), która nie ma otoki.
Do klucza dodaje się właściwość niestandardową.

Parametr options jest specjalnie używany do wskazywania następujących elementów:

Niezależnie od tego, czy właściwość jest wbudowana, czy niestandardowa.
Czy właściwość powinna być utrwalone za pomocą klucza.

Te opcje muszą być zgodne z wartością ustawioną przez właściwość lub właściwość nie zostanie znaleziona.

CryptographicException jest zgłaszany, jeśli nie można odnaleźć właściwości. Najpierw należy wywołać metodę HasProperty , aby uniknąć wyjątku zamiast zawijania wywołania metody w try/catch bloku.

Dotyczy