CertEnumCRLsInStore 함수(wincrypt.h)

아티클
08/27/2023

CertEnumCRLsInStore 함수는 인증서 저장소에서 첫 번째 또는 다음 CRL(인증서 해지 목록) 컨텍스트를 검색합니다. 루프에서 사용되는 이 함수는 인증서 저장소의 모든 CRL 컨텍스트를 순서대로 검색할 수 있습니다.

구문

PCCRL_CONTEXT CertEnumCRLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCRL_CONTEXT pPrevCrlContext
);

매개 변수

[in] hCertStore

인증서 저장소의 핸들입니다.

[in] pPrevCrlContext

찾은 이전 CRL_CONTEXT 구조체에 대한 포인터입니다. 저장소에서 첫 번째 CRL을 얻으려면 pPrevCrlContext 매개 변수가 NULL 이어야 합니다. 연속 CRL은 pPrevCrlContext 를 함수에 대한 이전 호출에서 반환된 포인터로 설정하여 열거됩니다. 이 함수는 이 매개 변수의 NULL이 아닌 값에서 참조하는 CRL_CONTEXT 해제합니다. 열거형은 CertDeleteCRLFromStore에서 이전에 삭제한 모든 CRL을 건너뜁니다.

반환 값

함수가 성공하면 반환 값은 저장소의 다음 CRL_CONTEXT 대한 포인터입니다.

함수가 실패하면 NULL이 반환됩니다. 확장 오류 정보는 GetLastError를 호출합니다. 몇 가지 가능한 오류 코드는 다음과 같습니다.

반환 코드	설명
E_INVALIDARG	hCertStore 매개 변수의 핸들은 pPrevCrlContext가 가리키는 인증서 컨텍스트의 핸들과 다릅니다.
CRYPT_E_NOT_FOUND	CRL을 찾을 수 없습니다. 이 문제는 저장소가 비어 있거나 매장 목록의 끝에 도달한 경우에 발생합니다.

설명

반환된 포인터는 함수에 대한 후속 호출에서 pPrevCrlContext 로 전달될 때 해제됩니다. 그렇지 않으면 CertFreeCRLContext를 호출하여 포인터를 명시적으로 해제해야 합니다. NULL이 아닌 pPrevCrlContext는 함수 자체가 오류를 반환하더라도 CertFreeCRLContext 호출을 통해 이 함수에 전달될 때 항상 해제됩니다.

이 함수에서 반환된 CRL 컨텍스트 의 중복은 CertDuplicateCRLContext를 호출하여 만들 수 있습니다.

요구 사항


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