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 함수에서 가장 일반적으로 반환되는 오류 코드를 나열합니다.
| 반환 코드 | 설명 |
|---|---|
|
hFile 매개 변수는 NULL이 아니어야 합니다.
hFile 매개 변수는 유효한 파일 핸들이어야 합니다. pcbHash 매개 변수는 NULL이 아니어야 합니다. dwFlags 매개 변수는 0이어야 합니다. |
|
pbHash 매개 변수가 가리키는 버퍼는 NULL이 아니지만 작성할 만큼 크지 않았습니다. 필요한 버퍼의 올바른 크기는 pcbHash 매개 변수가 가리키는 값에 포함됩니다. |
|
pwszHashAlgorithm 매개 변수로 지정된 해시 알고리즘을 찾을 수 없습니다. |
설명
이 함수를 실행하는 데 걸리는 시간은 해시되는 파일의 길이, 사용 중인 알고리즘 및 파일 위치에 따라 달라집니다. 예를 들어 매우 큰 로컬 파일의 해시를 계산하는 데 몇 초 정도 걸립니다(수백 메가바이트).
요구 사항
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | mscat.h |
| 라이브러리 | Wintrust.lib |
| DLL | Wintrust.dll |