CngKey.GetProperty(String, CngPropertyOptions) Metoda
Definicja
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.CngPropertyPublic Function GetProperty (name As String, options As CngPropertyOptions) As CngPropertyParametry
- 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
Obiekt, który zawiera nieprzetworzone wartości określonej właściwości.
- Atrybuty
Wyjątki
name to null.
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.
