CryptCATAdminEnumCatalogFromHash 함수(mscat.h)

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

CryptCATAdminEnumCatalogFromHash 함수는 지정된 해시를 포함하는 카탈로그를 열거합니다. 해시는 일반적으로 CryptCATAdminCalcHashFromFileHandle 함수에서 반환됩니다. 이 함수에 대한 최종 호출 후 CryptCATAdminReleaseCatalogContext 를 호출하여 할당된 메모리를 해제합니다.

구문

HCATINFO CryptCATAdminEnumCatalogFromHash(
  [in] HCATADMIN hCatAdmin,
  [in] BYTE      *pbHash,
  [in] DWORD     cbHash,
  [in] DWORD     dwFlags,
  [in] HCATINFO  *phPrevCatInfo
);

매개 변수

[in] hCatAdmin

이전에 CryptCATAdminAcquireContext 함수에서 할당한 카탈로그 관리자 컨텍스트에 대한 핸들입니다.

[in] pbHash

CryptCATAdminCalcHashFromFileHandle을 호출하여 검색된 해시를 포함하는 버퍼에 대한 포인터입니다.

[in] cbHash

pbHash에 할당된 버퍼의 바이트 수입니다.

[in] dwFlags

이 매개 변수는 나중에 사용할 수 있도록 예약되어 있으며 0으로 설정해야 합니다.

[in] phPrevCatInfo

이전 카탈로그 컨텍스트 또는 NULL에 대한 핸들에 대한 포인터입니다. 해시가 포함된 첫 번째 카탈로그를 얻거나 모든 카탈로그의 열거를 시작하려면 이 매개 변수에 대해 NULL 을 전달합니다. 열거형을 계속하려면 카탈로그를 더 이상 찾을 수 없을 때까지 이전 호출의 반환 값을 전달합니다.

반환 값

반환 값은 카탈로그 컨텍스트에 대한 핸들이거나 열거할 카탈로그가 더 이상 없는 경우 NULL 입니다.

참고: HCATINFO 형식은 단순히 HANDLE에 대한 typedef이므로 잘못된 컨텍스트에서 실수로 HCATINFO를 쉽게 사용할 수 있습니다. 특히 컴파일러가 카탈로그 핸들을 예상하는 함수에서 HCATINFO를 사용할 수 없더라도 CryptCATOpen에서 반환된 HANDLE과는 다릅니다. 이 함수에서 카탈로그 핸들을 가져오려면 먼저 CryptCATCatalogInfoFromContext 를 호출하여 카탈로그의 파일 이름을 가져오고 해당 파일 이름으로 CryptCATOpen 을 호출합니다.

확장된 오류 정보는 GetLastError 함수를 호출합니다. 운영 체제에서 제공하는 오류 코드의 전체 목록은 시스템 오류 코드를 참조하세요.

참고: 함수는 HCATINFO 형식의 값을 반환하지만 HANDLE에 대한 typedef일 뿐입니다. 이 때문에 다른 종류의 HANDLE이 필요한 함수를 호출할 때 실수로 HCATINFO를 사용하기 쉽습니다. 특히 컴파일러가 카탈로그 핸들을 예상하는 함수에서 HCATINFO를 사용할 수 없더라도 CryptCATOpen에서 반환된 HANDLE과는 다릅니다.

이 함수에서 카탈로그 핸들을 가져오려면 먼저 CryptCATCatalogInfoFromContext 를 호출하여 카탈로그의 파일 이름을 가져오고 해당 파일 이름으로 CryptCATOpen 을 호출하여 카탈로그를 엽니다.

요구 사항

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