Función BindImageEx (imagehlp.h)

Calcula la dirección virtual de cada función que se importa.

Sintaxis

BOOL IMAGEAPI BindImageEx(
  [in] DWORD                    Flags,
  [in] PCSTR                    ImageName,
  [in] PCSTR                    DllPath,
  [in] PCSTR                    SymbolPath,
  [in] PIMAGEHLP_STATUS_ROUTINE StatusRoutine
);

Parámetros

[in] Flags

Opciones de enlace. Este parámetro puede ser una combinación de los valores siguientes.

Value	Significado
BIND_ALL_IMAGES 0x00000004	Enlace todas las imágenes del árbol de llamadas para este archivo.
BIND_CACHE_IMPORT_DLLS 0x00000008	No descarte la información de DLL en la memoria caché entre llamadas. Esto mejora el rendimiento al enlazar un gran número de imágenes.
BIND_NO_BOUND_IMPORTS 0x00000001	No genere una nueva tabla de direcciones de importación.
BIND_NO_UPDATE 0x00000002	No realice cambios en el archivo.

[in] ImageName

Nombre del archivo que se va a enlazar. Este valor puede ser un nombre de archivo, una ruta de acceso parcial o una ruta de acceso completa.

[in] DllPath

Raíz de la ruta de acceso de búsqueda que se va a usar si no se puede abrir el archivo especificado por el parámetro ImageName .

[in] SymbolPath

Raíz de la ruta de acceso para buscar el archivo de símbolos correspondiente del archivo.

[in] StatusRoutine

Puntero a una rutina de estado. Se llama a la rutina de estado durante el progreso del enlace de imagen. Para obtener más información, consulte StatusRoutine.

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

El proceso de enlace de una imagen consiste en calcular la dirección virtual de cada función importada. A continuación, la dirección virtual calculada se guarda en la tabla de direcciones de importación (IAT) de la imagen de importación. Como resultado, la imagen se carga mucho más rápido, especialmente si usa muchos archivos DLL, ya que el cargador del sistema no tiene que calcular la dirección de cada función importada.

Si se puede encontrar un archivo de símbolos correspondiente, se actualizan su marca de tiempo y suma de comprobación.

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

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

StatusRoutine