Compartir a través de

Función ImageGetDigestStream (imagehlp.h)

  • Artículo

Recupera los datos solicitados del archivo de imagen especificado.

Sintaxis

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

Parámetros

[in] FileHandle

Identificador del archivo de imagen. Este identificador debe abrirse para FILE_READ_DATA acceso.

[in] DigestLevel

Aspectos de la imagen que se van a incluir en el flujo de datos devuelto. Este parámetro puede ser uno o más de los siguientes valores.

Valor Significado
CERT_PE_IMAGE_DIGEST_ALL_IMPORT_INFO
0x04
 Incluya toda la información de importación.
CERT_PE_IMAGE_DIGEST_DEBUG_INFO
0x01
 Incluir información de depuración simbólica.
CERT_PE_IMAGE_DIGEST_RESOURCES
0x02
 Incluir información de recursos.

[in] DigestFunction

Puntero a una rutina de devolución de llamada para procesar los datos. Para obtener más información, vea DigestFunction.

[in] DigestHandle

Identificador proporcionado por el usuario al resumen. Este parámetro se pasa a DigestFunction como primer argumento.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. Para recuperar información de error extendida, llame a GetLastError.

Comentarios

La función ImageGetDigestStream devuelve los datos que se van a resúmenes de un archivo de imagen especificado, sujeto al parámetro DigestLevel pasado. El orden de los bytes será coherente con las distintas llamadas, lo que es necesario para asegurarse de que siempre se genera el mismo resumen del mensaje a partir de la secuencia de bytes recuperada.

Para garantizar la compatibilidad multiplataforma, todas las implementaciones de esta función deben comportarse de forma coherente con respecto al orden en que se devuelven las distintas partes del archivo de imagen.

Los datos deben devolverse en el orden siguiente:

  1. Información de imagen (datos ejecutables y estáticos).
  2. Datos de recursos.
  3. Información de depuración.
Si no se especifica alguno de estos elementos, se deben devolver los elementos restantes en el mismo orden.

Todas las funciones ImageHlp, como esta, son un único subproceso. Por lo tanto, es probable que las llamadas desde más de un subproceso a esta función producirán un comportamiento inesperado o daños en la memoria. Para evitarlo, debe sincronizar todas las llamadas simultáneas de más de un subproceso a esta función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado imagehlp.h
Library Imagehlp.lib
Archivo DLL Imagehlp.dll

Consulte también

Funciones ImageHlp