CertAddCRLContextToStore 함수(wincrypt.h)
CertAddCRLContextToStore 함수는 지정된 인증서 저장소에 CRL(인증서 해지 목록) 컨텍스트를 추가합니다.
구문
BOOL CertAddCRLContextToStore(
[in] HCERTSTORE hCertStore,
[in] PCCRL_CONTEXT pCrlContext,
[in] DWORD dwAddDisposition,
[out, optional] PCCRL_CONTEXT *ppStoreContext
);
매개 변수
[in] hCertStore
인증서 저장소의 핸들입니다.
[in] pCrlContext
추가할 CRL_CONTEXT 구조체에 대한 포인터입니다.
[in] dwAddDisposition
일치하는 CRL 또는 일치하는 CRL에 대한 링크가 저장소에 이미 있는 경우 수행할 작업을 지정합니다. 현재 정의된 처리 값 및 해당 용도는 다음과 같습니다.
| 값 | 의미 |
|---|---|
|
기존 일치하는 CRL 또는 일치하는 CRL에 대한 링크를 검사 않습니다. 새 CRL은 항상 저장소에 추가됩니다. 이로 인해 저장소에서 중복이 발생할 수 있습니다. |
|
일치하는 CRL 또는 일치하는 CRL에 대한 링크가 있는 경우 작업이 실패합니다. GetLastError 는 CRYPT_E_EXISTS 코드를 반환합니다. |
|
일치하는 CRL 또는 일치하는 CRL에 대한 링크가 있는 경우 함수는 CRL의 ThisUpdate 시간을 비교합니다. 기존 CRL의 ThisUpdate 시간이 새 CRL의 ThisUpdate 시간보다 작으면 이전 CRL 또는 링크가 CERT_STORE_ADD_REPLACE_EXISTING 그대로 바뀝다. 기존 CRL에 추가할 CRL의 ThisUpdate 시간보다 크거나 같은 ThisUpdate 시간이 있는 경우 getLastError 가 CRYPT_E_EXISTS 코드를 반환하면서 함수가 실패합니다.
일치하는 CRL 또는 일치하는 CRL에 대한 링크를 저장소에 찾을 수 없는 경우 새 CRL이 저장소에 추가됩니다. |
|
작업은 이전 CRL을 대체하는 경우 이전 CRL의 속성이 대체 CRL에 통합된다는 점을 제외하고 CERT_STORE_ADD_NEWER 경우와 동일합니다. |
|
일치하는 CRL 또는 일치하는 CRL에 대한 링크가 있는 경우 기존 CRL 또는 링크가 삭제되고 새 CRL이 만들어지고 저장소에 추가됩니다. 일치하는 CRL 또는 일치하는 CRL에 대한 링크가 없는 경우 하나가 추가됩니다. |
|
일치하는 CRL이 저장소에 있는 경우 새 컨텍스트를 만들고 추가하기 전에 기존 컨텍스트가 삭제됩니다. 추가된 컨텍스트는 기존 CRL에서 속성을 상속합니다. |
|
일치하는 CRL 또는 일치하는 CRL에 대한 링크가 있는 경우 기존 CRL이 사용되고 새 CRL의 속성이 추가됩니다. 함수는 실패하지 않지만 새 CRL은 추가되지 않습니다. ppCertContext가 NULL이 아니면 기존 컨텍스트가 중복됩니다.
일치하는 CRL 또는 일치하는 CRL에 대한 링크가 없는 경우 새 CRL이 추가됩니다. |
[out, optional] ppStoreContext
디코딩된 CRL 컨텍스트에 대한 포인터에 대한 포인터입니다. 이는 선택적 매개 변수이며 호출 애플리케이션에 추가된 CRL 또는 기존 CRL의 복사본이 필요하지 않음을 나타내는 NULL일 수 있습니다. 복사본이 만들어지면 CertFreeCRLContext를 사용하여 해당 컨텍스트를 해제해야 합니다.
반환 값
함수가 성공하면 반환 값은 TRUE입니다.
함수가 실패하면 반환 값은 FALSE입니다. 호출된 함수 CertAddEncodedCRLToStore 및 CertSetCRLContextProperty 의 오류를 이 함수로 전파할 수 있습니다.
확장된 오류 정보는 GetLastError를 호출합니다. 몇 가지 가능한 오류 코드는 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
이 오류는 CERT_STORE_ADD_NEW 설정되고 CRL이 저장소에 이미 있거나 CERT_STORE_ADD_NEWER 설정되고 CRL이 추가될 CRL의 ThisUpdate 날짜보다 크거나 같은 이 업데이트 날짜가 있는 저장소에 있는 경우 반환됩니다. |
|
dwAddDisposition 매개 변수는 유효하지 않은 처리 값을 지정했습니다. |
설명
CRL 컨텍스트는 CertDuplicateCRLContext를 사용하여 중복되지 않습니다. 대신 새 복사본이 만들어지고 저장소에 추가됩니다. 인코딩된 CRL을 복사하는 것 외에도 함수는 컨텍스트의 속성을 복사합니다.
인증서 저장소에서 CRL 컨텍스트를 제거하려면 CertDeleteCRLFromStore 함수를 사용합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | wincrypt.h |
| 라이브러리 | Crypt32.lib |
| DLL | Crypt32.dll |