ImageGetDigestStream 함수(imagehlp.h)

지정된 이미지 파일에서 요청된 데이터를 검색합니다.

구문

BOOL IMAGEAPI ImageGetDigestStream(
  [in] HANDLE          FileHandle,
  [in] DWORD           DigestLevel,
  [in] DIGEST_FUNCTION DigestFunction,
  [in] DIGEST_HANDLE   DigestHandle
);

매개 변수

[in] FileHandle

이미지 파일에 대한 핸들입니다. 이 핸들은 FILE_READ_DATA 액세스를 위해 열어야 합니다.

[in] DigestLevel

반환된 데이터 스트림에 포함할 이미지의 측면입니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

값	의미
CERT_PE_IMAGE_DIGEST_ALL_IMPORT_INFO 0x04	모든 가져오기 정보를 포함합니다.
CERT_PE_IMAGE_DIGEST_DEBUG_INFO 0x01	기호 디버깅 정보를 포함합니다.
CERT_PE_IMAGE_DIGEST_RESOURCES 0x02	리소스 정보를 포함합니다.

[in] DigestFunction

데이터를 처리하는 콜백 루틴에 대한 포인터입니다. 자세한 내용은 DigestFunction을 참조하세요.

[in] DigestHandle

다이제스트에 대한 사용자 제공 핸들입니다. 이 매개 변수는 DigestFunction 에 첫 번째 인수로 전달됩니다.

반환 값

함수가 성공하면 반환 값은 TRUE입니다.

함수가 실패하면 반환 값은 FALSE입니다. 확장된 오류 정보를 검색하려면 GetLastError를 호출합니다.

설명

ImageGetDigestStream 함수는 전달된 DigestLevel 매개 변수에 따라 지정된 이미지 파일에서 다이제스트할 데이터를 반환합니다. 바이트 순서는 서로 다른 호출에 대해 일관되며, 이는 동일한 메시지 다이제스트가 항상 검색된 바이트 스트림에서 생성되도록 하는 데 필요합니다.

플랫폼 간 호환성을 보장하려면 이 함수의 모든 구현이 이미지 파일의 다양한 부분이 반환되는 순서와 관련하여 일관된 방식으로 동작해야 합니다.

데이터는 다음 순서로 반환되어야 합니다.

1. 이미지(실행 파일 및 정적 데이터) 정보입니다.
2. 리소스 데이터.
3. 디버깅 정보.

이러한 부분이 지정되지 않은 경우 나머지 부분은 동일한 순서로 반환되어야 합니다.

이 함수와 같은 모든 ImageHlp 함수는 단일 스레드입니다. 따라서 둘 이상의 스레드에서 이 함수로 호출하면 예기치 않은 동작이나 메모리 손상이 발생할 수 있습니다. 이를 방지하려면 둘 이상의 스레드에서 이 함수로의 모든 동시 호출을 동기화해야 합니다.

요구 사항

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

추가 정보

ImageHlp 함수