다음을 통해 공유

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