CertEnumCTLsInStore 함수(wincrypt.h)

아티클
03/03/2024

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

구문

PCCTL_CONTEXT CertEnumCTLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCTL_CONTEXT pPrevCtlContext
);

매개 변수

[in] hCertStore

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

[in] pPrevCtlContext

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

반환 값

함수가 성공하면 반환 값은 읽기 전용 CTL_CONTEXT 대한 포인터입니다.

함수가 실패하고 CTL을 찾을 수 없는 경우 반환 값은 NULL입니다. 확장된 오류 정보는 GetLastError를 호출합니다.

몇 가지 가능한 오류 코드는 다음과 같습니다.

반환 코드	설명
CRYPT_E_NOT_FOUND	저장소에 CTL이 없거나 함수가 저장소 목록의 끝에 도달했습니다.
E_INVALIDARG	hCertStore 매개 변수의 핸들은 pPrevCtlContext 매개 변수가 가리키는 CTL 컨텍스트의 핸들과 다릅니다.

설명

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

CertDuplicateCTLContext를 호출하여 중복을 만들 수 있습니다.

요구 사항

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