CngKey.GetProperty(String, CngPropertyOptions) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает свойство по заданному имени и набору параметров.
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 CngPropertyПараметры
- name
- String
Имя требуемого свойства.
- options
- CngPropertyOptions
Битовая комбинация значений перечисления, определяющих параметры именованного свойства.
Возвращаемое значение
Объект, в котором содержится необработанное значение заданного свойства.
- Атрибуты
Исключения
name имеет значение null.
Все остальные ошибки.
Комментарии
Цель этого метода — возврат значения произвольного свойства ключа. Типичным способом получения свойств является использование методов доступа к свойствам, предоставляемых классом CngKey . CngKey предоставляет оболочки для нескольких, но не всех свойств. Метод GetProperty в основном используется для доступа к значению свойства, которое не упаковано в оболочку.
Этот метод полезен в следующих случаях:
Новая версия операционной системы поддерживает новое свойство ключа шифрования следующего поколения (CNG), которое не имеет оболочки.
Вы добавляете пользовательское свойство в ключ.
Параметр options используется специально для указания следующего:
Является ли свойство встроенным или настраиваемым.
Указывает, следует ли сохранять свойство с помощью ключа.
Эти параметры должны соответствовать значению, которое было задано свойству, иначе свойство не будет найдено.
CryptographicException возникает, если свойство не удается найти. Сначала следует вызвать HasProperty метод , чтобы избежать исключения, а не упаковать вызов метода в try/catch блок.
