CngKey.GetProperty(String, CngPropertyOptions) Metoda

Definicja

Przestrzeń nazw:

System.Security.Cryptography

Zestaw:

System.Security.Cryptography.dll

Źródło:

Cng.NotSupported.cs

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

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.

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:

• Określa, czy właściwość jest wbudowana, czy niestandardowa.

• Określa, czy właściwość powinna być utrwalana za pomocą klucza.

Te opcje muszą być zgodne z wartością ustawioną dla właściwości lub nie można odnaleźć właściwości.

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.