CertEnumSubjectInSortedCTL 함수(wincrypt.h)

CertEnumSubjectInSortedCTL 함수는 정렬된 CTL(인증서 신뢰 목록)에서 첫 번째 또는 다음 TrustedSubject를 검색합니다. 정렬된 CTL은 CERT_CREATE_CONTEXT_SORTED_FLAG 집합으로 만든 CTL입니다. 루프에서 사용되는 이 함수는 정렬된 CTL의 모든 TrustedSubjects를 순서대로 검색할 수 있습니다.

구문

BOOL CertEnumSubjectInSortedCTL(
  [in]      PCCTL_CONTEXT   pCtlContext,
  [in, out] void            **ppvNextSubject,
  [out]     PCRYPT_DER_BLOB pSubjectIdentifier,
  [out]     PCRYPT_DER_BLOB pEncodedAttributes
);

매개 변수

[in] pCtlContext

검색할 CTL_CONTEXT 구조체에 대한 포인터입니다.

[in, out] ppvNextSubject

마지막으로 발견된 TrustedSubject의 주소에 대한 포인터입니다. 열거형을 시작하려면 ppvNextSubject 가 NULL로 설정된 포인터를 가리킵니다. 반환되면 ppvNextSubject 로 주소가 지정된 포인터가 인코딩된 시퀀스의 다음 TrustedSubject를 가리키도록 업데이트됩니다.

[out] pSubjectIdentifier

TrustedSubject를 고유하게 식별하는 CRYPT_DER_BLOB 구조체에 대한 포인터입니다. 이 구조의 정보는 해시 또는 고유한 바이트 시퀀스일 수 있습니다.

[out] pEncodedAttributes

바이트 수와 TrustedSubject의 인코딩된 특성에 대한 포인터를 포함하는 CRYPT_DER_BLOB 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값은 TRUE이고 ppvNextSubject 는 인코딩된 시퀀스에서 다음 TrustedSubject를 가리키도록 업데이트됩니다.

함수가 실패하면 반환 값은 FALSE입니다. 더 이상 주체가 없거나 유효하지 않은 인수가 있는 경우 반환 값은 FALSE 입니다.

설명

CRYPT_DER_BLOB 구조체의 pbData 멤버는 인코딩된 바이트를 직접 가리킵니다. CRYPT_DER_BLOB 구조체 자체는 애플리케이션에서 할당하고 해제해야 하지만 이러한 구조체의 pbData 멤버가 처리하는 메모리는 애플리케이션에서 할당되지 않으며 애플리케이션에서 해제해서는 안 됩니다.

CTL이 CERT_CREATE_CONTEXT_SORTED_FLAG 플래그 집합으로 정렬되지 않으면 오류가 발생합니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wincrypt.h
라이브러리	Crypt32.lib
DLL	Crypt32.dll

추가 정보

CTL_CONTEXT

CertFindSubjectInSortedCTL

인증서 및 인증서 저장소 유지 관리 기능