CryptCATAdminCalcHashFromFileHandle 함수(mscat.h)

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

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

구문

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

매개 변수

[in] hFile

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

[in, out] pcbHash

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

[in] pbHash

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

[in] dwFlags

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

반환 값

함수가 성공하면 반환 값이 TRUE 이고, 함수가 실패하면 FALSE 입니다. FALSE가 반환되면 GetLastError 함수를 호출하여 실패 이유를 확인합니다. pbHash에 충분한 메모리가 할당되지 않은 경우 CryptCATAdminCalcHashFromFileHandle 함수는 마지막 오류를 ERROR_INSUFFICIENT_BUFFER 설정합니다.

요구 사항

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