.\" -*- nroff -*-
.\" Generated file - DO NOT EDIT!
.TH ImageGetDigestStream 3w "Oct 2012" "Wine API" "Wine API"

.SH NAME
\fBImageGetDigestStream\fR (IMAGEHLP.@)
.SH SYNOPSIS
BOOL ImageGetDigestStream
 (
  HANDLE          \fIFileHandle\fR,
  DWORD           \fIDigestLevel\fR,
  DIGEST_FUNCTION \fIDigestFunction\fR,
  DIGEST_HANDLE   \fIDigestHandle\fR
 )

.SH DESCRIPTION
.PP
Gets a stream of bytes from a \fBPE\fR file over which a hash might be computed to verify that the image has not changed. Useful for creating a certificate to be added to the file with ImageAddCertificate. 

.SH PARAMS
\fIFileHandle\fR \fB[In]\fR  File for which to return a stream.
.PP
\fIDigestLevel\fR \fB[In]\fR  Flags to control which portions of the file to return. \fB0\fR is allowed, as is any combination of: CERT_PE_IMAGE_DIGEST_ALL_IMPORT_INFO: reports the entire import section rather than selected portions of it. CERT_PE_IMAGE_DIGEST_DEBUG_INFO: reports the debug section. CERT_PE_IMAGE_DIGEST_RESOURCES: reports the resources section.
.PP
\fIDigestFunction\fR \fB[In]\fR  Callback function.
.PP
\fIDigestHandle\fR \fB[In]\fR  Handle passed as first parameter to \fIDigestFunction\fR.
.PP

.SH RETURNS
.PP
\fBTRUE\fR if successful. \fBFALSE\fR if unsuccessful. GetLastError returns more about the error. 

.SH NOTES
.PP
Only supports \fB32\fR-bit \fBPE\fR files, not tested with any other format. Reports data in the following order: 1. The file headers are reported first 2. Any code sections are reported next. 3. The data (\fB".data"\fR and \fB".rdata"\fR) sections are reported next. 4. The import section is reported next. 5. If \fBCERT_PE_IMAGE_DIGEST_DEBUG_INFO\fR is set in \fIDigestLevel\fR, the debug section is reported next. 6. If \fBCERT_PE_IMAGE_DIGEST_RESOURCES\fR is set in \fIDigestLevel\fR, the resources section is reported next. 

.SH BUGS
.PP
\fBCERT_PE_IMAGE_DIGEST_ALL_IMPORT_INFO\fR must be specified, returns an error if not. 

.SH IMPLEMENTATION
.PP
Declared in \fB"imagehlp.h"\fR. 
.PP
Implemented in \fB"dlls/imagehlp/integrity.c"\fR. 
.PP
Debug channel \fB"imagehlp"\fR.