На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

ImageGetDigestStream



[Now Supported on Windows NT]

The ImageGetDigestStream function returns the data to be digested from a given image file, subject to the passed DigestLevel parameter.

BOOL ImageGetDigestStream(

IN HANDLE FileHandle,
IN DWORD DigestLevel,
IN PVOID Buffer,
IN OUT PDWORD BufferLength,
IN OUT PDWORD Context
);


Parameters

FileHandle

This supplies a handle to the image file to be modified. This handle must be opened for FILE_READ_DATA access.

DigestLevel

This indicates which aspects of the image are to be included in the returned data stream. The flag values are:

· DICE_PE_IMAGE_DIGEST_DEBUG_INFO
· DICE_PE_IMAGE_DIGEST_RESOURCES

Buffer

Provides a pointer to a buffer for the returned data.

BufferLength

On input, this supplies the size of the passed Buffer in bytes. On output, it returns the amount of data remaining in the image. Thus, an application can pass in a BufferLength of zero to determine exactly how much space is required to retrieve all the data in a single pass.

Context

Supplies and returns cross-call context information so sequential calls can return data blocks without requiring the system to maintain state information about the operation in progress.

This parameter must be zero on the first call for accurate results.



Return Values

If the function succeeds, the return value is TRUE.
If the function fails, then the return value is FALSE. To retrieve extended error information, call GetLastError.

Remarks

The ImageGetDigestStream function returns the data to be digested from a given image file, subject to the passed DigestLevel parameter. The order of the bytes will be consistent for different calls, which is required to ensure that the same message digest is always produced from the retrieved byte stream.
To ensure cross-platform compatibility, all implementations of this function must behave in a consistent manner with respect to the order in which the various parts of the image file are returned.

Data should be returned in the following order:

1. Image (executable and static data) information.
2. Resource data.
3. Debug information.



If any of these are not specified, the remaining parts must be returned in the same order.
Windows NT: This function is not available under Windows NT 3.51; it was introduced in Windows NT 4.0.


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

ImageGetDigestStream



[Теперь Поддерживанное на Windows NT]

Функция ImageGetDigestStream возвращает данные, которые нужно усваиваться из данного файла образа, подлежавшего прошедшему параметру DigestLevel.

BOOL ImageGetDigestStream(

В РУЧКЕ FileHandle, В DWORD DigestLevel, В Буфере PVOID, В PDWORD BufferLength, В Контексте PDWORD
);


Параметры

FileHandle

Это поставляет ручку в файл образа, который нужно модифицироваться. Эта ручка должна быть открыта для доступа FILE_READ_DATA.

DigestLevel

Это указывает, что какие аспекты образа должны быть включены в возвращанный поток данных. Величины флага:

DICE_PE_IMAGE_DIGEST_DEBUG_INFO DICE_PE_IMAGE_DIGEST_RESOURCES

Буфер

Обеспечивает указатель в буфер для возвращанных данных.

BufferLength

На вводе, это поставляет размер прошедшего Буфера в байты. На выходе, это возвращает сумму данных, остающихся в образе. Таким образом, приложение может пройти в BufferLength нуля, чтобы определять точно требуется, чтобы сколько пространство извлекло все данные в однопроходный проход.

Контекст

Поставки и возврат перекрестная-контекстная информация вызова такие последовательные вызовы могут возвращать блоков данных не требуя систему, чтобы поддерживать государственную информацию об операции в процессе развития.

Этот параметр должен быть нулем в первом призыве к точным результатам.



Обратные Величины

Если функция добивается успеха, обратная величина является ИСТИНОЙ.
Если функция терпит неудачу, тогда обратная величина ЛОЖНАЯ. Для того, чтобы извлекать расширенную информацию ошибки, назовите GetLastError.

Замечания

Функция ImageGetDigestStream возвращает данные, которые нужно усваиваться из данного файла образа, подлежавшего прошедшему параметру DigestLevel. Порядок байтов будет последовательным для других вызовов, которые требуется, чтобы проверил, что то же краткое изложение сообщения всегда произведено из извлеченного байтового потока.
Для того, чтобы гарантировать перекрестная платформа совместимости, все реализации этой функции должны провестися себя в последовательном способе что касается порядка в котором различные части файла образа возвращаны.

Данные должны возвращаться в следующем порядке:

1. Образ (программа и статические данные) информация.
2. Данные Ресурса.
3. Отладочная информация.



Если любое из их не определен, остальные части должны возвращаться в той же последовательности.
Windows NT: Эта функция не доступна под Windows NT 3.51; было введено в Windows NT 4.0.


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz