BindImageEx function

Computes the virtual address of each function that is imported.

Syntax


BOOL BindImageEx(
  _In_  DWORD Flags,
  _In_  PSTR ImageName,
  _In_  PSTR DllPath,
  _In_  PSTR SymbolPath,
  _In_  PIMAGEHLP_STATUS_ROUTINE StatusRoutine
);

Parameters

Flags [in]

The bind options. This parameter can be a combination of the following values.

ValueMeaning
BIND_ALL_IMAGES
0x00000004

Bind all images in the call tree for this file.

BIND_CACHE_IMPORT_DLLS
0x00000008

Do not discard DLL information in the cache between calls. This improves performance when binding a large number of images.

BIND_NO_BOUND_IMPORTS
0x00000001

Do not generate a new import address table.

BIND_NO_UPDATE
0x00000002

Do not make changes to the file.

 

ImageName [in]

The name of the file to be bound. This value can be a file name, a partial path, or a full path.

DllPath [in]

The root of the search path to use if the file specified by the ImageName parameter cannot be opened.

SymbolPath [in]

The root of the path to search for the file's corresponding symbol file.

StatusRoutine [in]

A pointer to a status routine. The status routine is called during the progress of the image binding. For more information, see StatusRoutine.

Return value

If the function succeeds, the return value is TRUE.

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

Remarks

The process of binding an image consists of computing the virtual address of each imported function. The computed virtual address is then saved in the importing image's Import Address Table (IAT). As a result, the image is loaded much faster, particularly if it uses many DLLs, because the system loader does not have to compute the address of each imported function.

If a corresponding symbol file can be located, its time stamp and checksum are updated.

All ImageHlp functions, such as this one, are single threaded. Therefore, calls from more than one thread to this function will likely result in unexpected behavior or memory corruption. To avoid this, you must synchronize all concurrent calls from more than one thread to this function.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Imagehlp.h

Library

Imagehlp.lib

DLL

Imagehlp.dll

See also

ImageHlp Functions
StatusRoutine

 

 

Community Additions

ADD
Show:
© 2014 Microsoft