CryptCATAdminAddCatalog 함수(mscat.h)
[ CryptCATAdminAddCatalog 함수는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]
CryptCATAdminAddCatalog 함수는 카탈로그 데이터베이스에 카탈로그를 추가합니다. 카탈로그 데이터베이스는 파일 해시를 포함하는 카탈로그와 연결하는 인덱스입니다. 파일 서명을 확인할 때 카탈로그 식별 속도를 높이기 위해 사용됩니다. 이 함수는 Windows 카탈로그 데이터베이스에 카탈로그를 프로그래밍 방식으로 추가하는 유일한 지원 방법입니다. 함수에 연결된 가져오기 라이브러리가 없습니다. LoadLibrary 및 GetProcAddress 함수를 사용하여 Wintrust.dll 동적으로 연결해야 합니다.
구문
HCATINFO CryptCATAdminAddCatalog(
[in] HCATADMIN hCatAdmin,
[in] PWSTR pwszCatalogFile,
[in] PWSTR pwszSelectBaseName,
[in] DWORD dwFlags
);
매개 변수
[in] hCatAdmin
이전에 CryptCATAdminAcquireContext 함수에서 할당한 핸들입니다.
[in] pwszCatalogFile
추가할 카탈로그의 정규화된 경로에 대한 null로 끝나는 문자열에 대한 포인터입니다.
[in] pwszSelectBaseName
카탈로그가 저장될 때 카탈로그 이름에 대한 null로 끝나는 문자열에 대한 포인터입니다. 매개 변수가 NULL이면 카탈로그에 대해 고유한 이름이 생성됩니다.
[in] dwFlags
CRYPTCAT_ADDCATALOG_HARDLINK(0x00000001) 플래그를 지정하면 호출에 지정된 카탈로그가 복사되지 않고 하드 연결됩니다. 카탈로그를 복사하는 대신 하드 연결하면 Windows에 필요한 디스크 공간의 양이 줄어듭니다.
반환 값
함수가 성공하면 반환 값은 카탈로그 정보 컨텍스트에 대한 핸들입니다. 함수가 실패하면 반환 값은 NULL입니다. 반환된 핸들 사용을 완료한 후 CryptCATAdminReleaseCatalogContext 함수를 호출하여 해제합니다.
확장된 오류 정보는 GetLastError 함수를 호출합니다. 운영 체제에서 제공하는 오류 코드의 전체 목록은 시스템 오류 코드를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | mscat.h |
| 라이브러리 | Wintrust.lib |
| DLL | Wintrust.dll |