CngKey.GetProperty(String, CngPropertyOptions) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
이름 및 속성 옵션 집합을 사용하여 속성을 가져옵니다.
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(Cryptography Next Generation) 키 속성을 지원합니다.
키에 사용자 지정 속성을 추가합니다.
매개 options 변수는 다음을 나타내는 데 특히 사용됩니다.
속성이 기본 제공인지 사용자 지정인지 여부입니다.
속성을 키와 함께 유지할지 여부입니다.
이러한 옵션은 속성이 설정된 값과 일치해야 합니다. 그렇지 않으면 속성을 찾을 수 없습니다.
CryptographicException 는 속성을 찾을 수 없는 경우 throw됩니다. 메서드 호출을 HasProperty 블록에 래핑하는 대신 예외를 방지하려면 먼저 메서드를 try/catch 호출해야 합니다.