CryptCATOpen 함수(mscat.h)

[ CryptCATOpen 함수는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

CryptCATOpen 함수는 카탈로그를 열고 열려 있는 카탈로그에 컨텍스트 핸들을 반환합니다.

참고 일부 이전 버전의 Wintrust.lib에는 이 함수에 대한 내보내기 정보가 포함되어 있지 않습니다. 이 경우 LoadLibrary 및 GetProcAddress 함수를 사용하여 Wintrust.dll 동적으로 연결해야 합니다.

 

구문

HANDLE CryptCATOpen(
  [in] LPWSTR     pwszFileName,
  [in] DWORD      fdwOpenFlags,
  [in] HCRYPTPROV hProv,
  [in] DWORD      dwPublicVersion,
  [in] DWORD      dwEncodingType
);

매개 변수

[in] pwszFileName

카탈로그 파일 이름의 null로 끝나는 문자열에 대한 포인터입니다.

[in] fdwOpenFlags

기존 카탈로그 파일을 열거나 다음 값 중 하나 이상의 비트 조합을 열려면 0입니다.

값	의미
CRYPTCAT_OPEN_ALWAYS	파일이 있는 경우 파일을 열거나 필요한 경우 새 파일을 만듭니다.
CRYPTCAT_OPEN_CREATENEW	새 카탈로그 파일이 만들어집니다. 이전에 만든 파일이 있으면 덮어씁니다.
CRYPTCAT_OPEN_EXISTING	기존 카탈로그 파일이 열립니다.
CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES	기존 카탈로그 파일이 열립니다. SPC_INDIRECT_DATA 페이지 해시를 제외합니다.
CRYPTCAT_OPEN_INCLUDE_PAGE_HASHES	기존 카탈로그 파일이 열립니다. SPC_INDIRECT_DATA 페이지 해시를 포함합니다. 또한 설정된 경우 위의 CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES 우선합니다.
CRYPTCAT_OPEN_VERIFYSIGHASH	기존 카탈로그 파일이 열립니다. 인증서가 아닌 서명을 확인합니다.
CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG	기존 카탈로그 파일이 열립니다. 콘텐츠 없이 CryptMsgDecode를 수행합니다.
CRYPTCAT_OPEN_SORTED	기존 카탈로그 파일이 열립니다. CertCreateContext(CERT_CREATE_CONTEXT_SORTED_FLAG)를 수행합니다.

[in] hProv

CSP(암호화 서비스 공급자)에 대한 핸들입니다.

[in] dwPublicVersion

파일 버전입니다. 다음 값 중 하나일 수 있습니다.

값	의미
CRYPTCAT_VERSION_1 0x100	버전 1 파일 형식입니다.
CRYPTCAT_VERSION_2 0x200	버전 2 파일 형식입니다. Windows 8 및 Windows Server 2012: 이 값에 대한 지원이 시작됩니다.

[in] dwEncodingType

파일에 사용되는 인코딩 형식입니다. 이 값이 0이면 인코딩 형식이 PKCS_7_ASN_ENCODING | 로 설정됩니다. X509_ASN_ENCODING.

반환 값

성공하면 이 함수는 열린 카탈로그에 대한 핸들을 반환합니다. 핸들 사용을 마쳤으면 CryptCATClose 함수를 호출하여 핸들을 닫습니다. CryptCATOpen 함수는 실패할 경우 INVALID_HANDLE_VALUE 반환합니다.

요구 사항

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

참고 항목

CryptCATClose