IX509CertificateRequestPkcs10::get_CspStatuses 메서드(certenroll.h)

아티클
08/22/2023

CspStatuses 속성은 인증서 요청과 연결된 프라이빗 키의 의도된 사용과 일치하는 ICspStatus 개체의 컬렉션을 검색합니다.

이 속성은 읽기 전용입니다.

구문

HRESULT get_CspStatuses(
  ICspStatuses **ppValue
);

매개 변수

ppValue

반환 값

없음

설명

이 속성은 ICspStatus 개체의 컬렉션을 검색합니다. 각 개체는 단일 공급자/알고리즘 쌍을 나타냅니다. CspStatuses 속성은 GetCspStatuses 메서드와 다릅니다. 메서드를 사용하면 KeySpec 매개 변수를 설정할 수 있지만 CspStatuses는 IX509CertificateRequestPkcs10 개체와 연결된 프라이빗 키에 설정된 KeySpec 속성을 사용합니다. 다음 값 중 하나일 수 있습니다.

값	Description
XCN_AT_NONE	암호화 API: 차세대(CNG) 공급자만 선택됩니다.
XCN_AT_KEYEXCHANGE	암호화 알고리즘(키 교환 포함)이 있는 CSP(CryptoAPI 암호화 서비스 공급자)만 선택됩니다.
XCN_AT_SIGNATURE	서명 알고리즘이 있는 CryptoAPI CSP(암호화 서비스 공급자)만 선택됩니다.

요청 개체를 초기화할 때 템플릿을 지정하는 경우 pKIDefaultCSP 및 pKIDefaultKeySpec 과 같은 템플릿 특성은 컬렉션에서 처음에 사용하도록 설정된 공급자/알고리즘 쌍에 영향을 줍니다. 각 ICspStatus 개체에서 다음 속성을 호출하여 쌍에 대한 정보를 검색할 수 있습니다.

CspInformation 속성은 공급자 정보를 검색합니다.
CspAlgorithm 속성은 알고리즘 정보를 검색합니다.
EnrollmentStatus 속성은 IX509EnrollmentStatus 개체를 검색합니다. 상태 개체에서 Selected 속성을 호출하여 이 요청에 대해 공급자/알고리즘 쌍을 사용할 수 있는지 여부를 확인합니다.
서수 속성은 공급자/알고리즘 쌍의 컬렉션에서 위치를 검색합니다.

이 메서드에서 검색한 컬렉션은 요청 개체에 내부적으로 저장됩니다. 컬렉션은 PKCS #10 개체가 계속 존재하는 한 존재합니다.

예를 들어 요청 개체와 연결된 프라이빗 키의 KeySpec 속성이 XCN_AT_SIGNATURE 설정되고 템플릿이 요청을 초기화하는 데 사용된다고 가정합니다. 다음 문은 true입니다.

ICspStatus 개체의 컬렉션이 만들어지고 IX509CertificateRequestPkcs10 개체에 저장됩니다. 컬렉션에는 컴퓨터에 설치된 모든 유효한 공급자/알고리즘 쌍이 포함됩니다.
KeySpec 속성이 XCN_AT_NONE 설정되지 않았으므로 Selected 속성은 컬렉션의 각 암호화 API: Next Generation(CNG) 공급자/알고리즘 쌍에 대해 SelectedNo로 설정됩니다.
KeySpec 속성이 XCN_AT_KEYEXCHANGE 설정되지 않았으므로 컬렉션에서 알고리즘을 사용하여 데이터를 암호화하거나 키를 보관할 수 있는 각 CryptoAPI CSP/알고리즘 쌍에 대해 SelectedNo로 설정됩니다.
템플릿 또는 프라이빗 키에서 참조하지만 컴퓨터에서 지원되지 않는 각 공급자에 대해 자리 표시자 ICspStatus 개체가 만들어지고 컬렉션에 추가되고 Selected 속성이 SelectedNo로 설정됩니다.
Selected 속성은 알고리즘을 사용하여 데이터에 서명할 수 있는 각 CryptoAPI CSP/알고리즘 쌍에 대해 SelectedYes로 설정됩니다.
서수 속성은 pKIDefaultCSPs 템플릿 특성으로 식별되는 CSP 순서(있는 경우)를 반영하도록 설정됩니다. 특성에 의해 먼저 나열된 CSP는 컬렉션에서 먼저 정렬됩니다. 이 속성은 프라이빗 키를 만들어야 하는 경우 등록 중에 사용됩니다. 첫 번째 선택한 CSP/알고리즘 쌍은 키를 만드는 데 사용되지만 작업이 실패하면 선택한 다음 쌍이 시도됩니다.

이 메서드를 호출하기 전에 IX509CertificateRequestPkcs10 개체를 초기화해야 합니다. 자세한 내용은 다음 방법 중 일부를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	certenroll.h
DLL	CertEnroll.dll