CryptCATAdminCalcHashFromFileHandle2 함수(mscat.h)

CryptCATAdminCalcHashFromFileHandle2 함수는 지정된 알고리즘을 사용하여 파일의 해시를 계산합니다.

이 함수에는 연결된 가져오기 라이브러리가 없습니다. LoadLibrary 및 GetProcAddress 함수를 사용하여 Wintrust.dll 동적으로 연결해야 합니다.

구문

BOOL CryptCATAdminCalcHashFromFileHandle2(
  [in]      HCATADMIN hCatAdmin,
  [in]      HANDLE    hFile,
  [in, out] DWORD     *pcbHash,
            BYTE      *pbHash,
            DWORD     dwFlags
);

매개 변수

[in] hCatAdmin

열린 카탈로그 관리자 컨텍스트의 핸들입니다. 자세한 내용은 CryptCATAdminAcquireContext2를 참조하세요.

[in] hFile

해시가 계산되는 파일에 대한 핸들입니다. 이 매개 변수는 NULL 일 수 없으며 유효한 파일 핸들이어야 합니다.

[in, out] pcbHash

pbHash 매개 변수의 바이트 수를 포함하는 DWORD 변수에 대한 포인터입니다. 입력 시 pcbHash 를 pbHash에 할당된 바이트 수로 설정합니다. 반환 시 pcbHash 에는 pbHash에서 반환된 바이트 수가 포함됩니다. pbHash가 NULL로 설정된 경우 pcbHash에는 pbHash에 할당할 바이트 수가 포함됩니다.

pbHash

해시를 수신하는 BYTE 버퍼에 대한 포인터입니다. 이 매개 변수를 NULL로 설정하면 pcbHash 는 pbHash에 할당할 바이트 수를 포함하며, 해시를 검색하기 위해 후속 호출을 수행할 수 있습니다.

dwFlags

예약되어 있습니다. 이 값은 0이어야 합니다.

반환 값

함수가 성공하면 반환 값은 0이 아닌 값(TRUE)입니다.

함수가 실패하면 반환 값은 0(FALSE)입니다. 확장 오류 정보는 GetLastError를 호출합니다.

다음 표에서는 GetLastError 함수에서 가장 일반적으로 반환되는 오류 코드를 나열합니다.

반환 코드	설명
ERROR_INVALID_PARAMETER	hFile 매개 변수는 NULL이 아니어야 합니다. hFile 매개 변수는 유효한 파일 핸들이어야 합니다. pcbHash 매개 변수는 NULL이 아니어야 합니다. dwFlags 매개 변수는 0이어야 합니다.
ERROR_INSUFFICIENT_BUFFER	pbHash 매개 변수가 가리키는 버퍼는 NULL이 아니지만 작성할 만큼 크지 않았습니다. 필요한 버퍼의 올바른 크기는 pcbHash 매개 변수가 가리키는 값에 포함됩니다.
NTE_BAD_ALGID	pwszHashAlgorithm 매개 변수로 지정된 해시 알고리즘을 찾을 수 없습니다.

설명

이 함수를 실행하는 데 걸리는 시간은 해시되는 파일의 길이, 사용 중인 알고리즘 및 파일 위치에 따라 달라집니다. 예를 들어 매우 큰 로컬 파일의 해시를 계산하는 데 몇 초 정도 걸립니다(수백 메가바이트).

요구 사항

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

참고 항목

CryptCATAdminCalcHashFromFileHandle

CryptCATAdminCalcHashFromFileHandle2