ICspStatuses::get_ItemByOrdinal 메서드(certenroll.h)
ItemByOrdinal 속성은 서수로 컬렉션에서 ICspStatus 개체를 검색합니다.
이 속성은 읽기 전용입니다.
구문
HRESULT get_ItemByOrdinal(
LONG Ordinal,
ICspStatus **ppValue
);
매개 변수
Ordinal
ppValue
반환 값
없음
설명
컬렉션에 있는 ICspStatus 개체의 서수 순서는 다음과 같은 다양한 이유로 컬렉션이 열거될 때마다 달라질 수 있습니다.
- 인증서 요청 템플릿 설정
- 암호화 공급자의 속성 값
- 프라이빗 키 속성 값
예를 들어 인증서 요청을 만들기 위해 선택한 버전 2 템플릿이 서명에만 인증서를 사용할 수 있고( pKIDefaultKeySpec 템플릿 특성이 XCN_AT_SIGNATURE) 기본 공급자가 Microsoft 고급 RSA 및 AES 암호화 공급자라고 가정합니다. 공급자가 암호화 및 서명 알고리즘을 모두 지원하더라도 템플릿은 인증서를 서명으로 제한합니다. 즉, 공급자의 KeySpec 속성은 XCN_AT_KEYEXCHANGE 및 XCN_AT_SIGNATURE 상수의 비트 조합이지만 pKIDefaultKeySpec 템플릿 특성은 XCN_AT_SIGNATURE만 지원합니다.
컬렉션의 ICspStatus 개체는 다음과 같은 방식으로 정렬됩니다.
- 이 공급자에 대해 열거된 ICspStatus 개체 중 서명 알고리즘(XCN_AT_SIGNATURE)과 연결된 개체는 먼저 정렬되고(하위 서수 값) 표시 및 선택한 속성이 사용하도록 설정됩니다. 참고pKIDefaultKeySpec 템플릿 특성이 XCN_AT_KEYEXCHANGE 경우 암호화 알고리즘이 먼저 정렬됩니다.
- 이 공급자에 대해 열거된 ICspStatus 개체 중 암호화 알고리즘(XCN_AT_KEYEXCHANGE)과 연결된 개체는 나중에 정렬되고(더 높은 서수 값) 표시 및 선택한 속성이 사용하도록 설정되지 않습니다.
- 비대칭 서명 알고리즘(XCN_AT_SIGNATURE)을 지원하지만 지정된 공급자와 연결되지 않은 다른 모든 설치된 CryptoAPI 공급자의 경우 Display 속성이 활성화되고 Selected 속성이 사용하도록 설정되지 않습니다.
- 비대칭 암호화 알고리즘(XCN_AT_KEYEXCHANGE)을 지원하는 설치된 다른 모든 CryptoAPI 공급자의 경우 표시 및 선택한 속성이 사용하도록 설정되지 않습니다.
- 설치된 모든 암호화 API: 차세대(CNG) 공급자의 경우 표시 및 선택한 속성이 사용하도록 설정되지 않습니다.
또 다른 예제에서는 버전 3 템플릿이 하나의 특정 CNG 공급자 및 알고리즘을 지정한다고 가정합니다. 해당 공급자/알고리즘 쌍(ICspStatus 개체)이 먼저 정렬되고 표시를 사용하도록 설정되고 선택됩니다. 해당 공급자가 지원하는 다른 모든 알고리즘은 나중에 정렬되고 표시할 수 없으며 선택되지 않습니다. 지정된 알고리즘을 지원하는 다른 모든 공급자는 나중에 계속 정렬되고 표시를 사용하도록 설정되지만 선택되지는 않습니다. 나머지 공급자/알고리즘 쌍은 모두 표시할 수 없으며 선택되지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | certenroll.h |
| DLL | CertEnroll.dll |