ICspStatus::get_Ordinal 메서드(certenroll.h)

Ordinal 속성은 ICspStatuses 컬렉션에서 ICspStatus 개체의 위치를 지정하거나 검색합니다.

이 속성은 읽기/쓰기가 가능합니다.

구문

HRESULT get_Ordinal(
  LONG *pValue
);

매개 변수

pValue

반환 값

없음

설명

서수별로 ICspStatuses 컬렉션을 반복하려면 ItemByOrdinal 속성을 호출합니다. 컬렉션에 있는 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 개체)이 먼저 정렬되고 표시를 사용하도록 설정되고 선택됩니다. 해당 공급자가 지원하는 다른 모든 알고리즘은 나중에 정렬되고 표시할 수 없으며 선택되지 않습니다. 지정된 알고리즘을 지원하는 다른 모든 공급자는 나중에 순서가 지정되고 표시할 수 있지만 선택되지는 않습니다. 나머지 공급자/알고리즘 쌍은 모두 표시할 수 없으며 선택되지 않습니다.

참고 CNG 공급자는 KeySpec 의도 사용 개념을 지원하지 않습니다. 이 속성 값에 대한 XCN_AT_NONE 반환합니다.

 

요구 사항

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

추가 정보

ICspStatus

ICspStatuses