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

추가 정보

CryptCATAdminAcquireContext

CryptCATAdminReleaseCatalogContext