CERT_STORE_PROV_INFO 구조체(wincrypt.h)
CERT_STORE_PROV_INFO 구조에는 를 사용하여 저장소를 열 때 설치된 CertDllOpenStoreProv 함수에서 반환된 정보가 포함됩니다.
CertOpenStore 함수입니다.
저장소를 열 때 CertOpenStore 함수는 CERT_STORE_PROV_INFO 구조의 모든 필드를 cbSize를 제외하고 0으로 설정합니다. 이 필드는 CERT_STORE_PROV_INFO 크기로 설정됩니다. 구조체는 CertDllOpenStoreProv 설치 가능 함수에 의해 업데이트됩니다. 호출할 추가 콜백 함수가 없는 경우 반환 시 cStoreProvFunc 는 0으로 유지됩니다.
구문
typedef struct _CERT_STORE_PROV_INFO {
DWORD cbSize;
DWORD cStoreProvFunc;
void **rgpvStoreProvFunc;
HCERTSTOREPROV hStoreProv;
DWORD dwStoreProvFlags;
HCRYPTOIDFUNCADDR hStoreProvFuncAddr2;
} CERT_STORE_PROV_INFO, *PCERT_STORE_PROV_INFO;
멤버
cbSize
이 구조체의 크기(바이트)를 포함합니다.
cStoreProvFunc
rgpvStoreProvFunc 배열의 요소 수를 포함합니다. 이 개수에는 마지막 콜백 함수가 구현되기 전에 인덱스에 사용되는 NULL 값이 포함되어야 합니다. 예를 들어 하나의 콜백 함수만 구현되었지만 인덱스 2(CERT_STORE_PROV_WRITE_CERT_FUNC)에 있는 경우 인덱스 0 및 1의 경우 이 매개 변수에 대해 숫자 3을 전달해야 합니다.
rgpvStoreProvFunc
공급자가 구현하는 콜백 함수에 대한 포인터 배열입니다. 이 배열은 다음 표에 제공된 값에 의해 인덱싱되며 표시된 순서대로 되어 있어야 합니다. 연결된 콜백 함수도 표시됩니다. 구현되지 않은 모든 콜백 함수는 NULL로 설정해야 합니다. 배열은 모든 콜백 함수 인덱스를 포함할 필요가 없으며 구현된 가장 높은 콜백 함수 인덱스만 포함하면 됩니다. 예를 들어 CERT_STORE_PROV_WRITE_CERT_FUNC (2) 콜백 함수만 구현되는 경우 배열에는 세 개의 요소만 포함되어야 합니다.
hStoreProv
모든 콜백에 전달된 첫 번째 매개 변수인 32비트 애플리케이션 정의 값입니다. 애플리케이션은 이 멤버의 내용을 원하는 대로 지정할 수 있습니다. 일반적으로 이 포인터는 열려 있는 각 저장소에 대한 공급자 상태 정보와 같이 애플리케이션과 관련된 데이터에 대한 포인터입니다.
dwStoreProvFlags
공급자의 작동 방식을 지정하는 플래그 집합을 포함합니다. 다음 값 중 하나 이상의 조합 또는 0을 포함합니다.
| 값 | 의미 |
|---|---|
|
공급자는 저장소 의 캐시 외부에 있는 인증서, 인증서 해지 목록 및 인증서 신뢰 목록을 저장합니다. |
|
저장소가 성공적으로 삭제되었습니다. CertStoreProvCloseCallback 콜백이 호출되지 않습니다. |
|
기본적으로 공급자는 저장소에 적용된 변경 내용을 유지합니다. 이 플래그가 설정되면 공급자는 저장소에 대한 변경 내용을 유지하지 않습니다. |
|
공급자는 시스템 저장소에 컨텍스트를 유지합니다. |
|
공급자는 LocalMachine 시스템 저장소에 컨텍스트를 유지합니다. |
hStoreProvFuncAddr2
CryptGetOIDFunctionAddress에서 반환된 핸들을 포함합니다. CertCloseStore 는 CryptFreeOIDFunctionAddress 를 호출하여 null이 아닌 hStoreProvFuncAddr2를 해제합니다. 이렇게 하면 콜백이 저장소를 닫을 때 해제될 다른 설치 가능한 함수를 호출할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 머리글 | wincrypt.h |