Computes the virtual address of each function that is imported.
BOOL IMAGEAPI BindImageEx( DWORD Flags, PCSTR ImageName, PCSTR DllPath, PCSTR SymbolPath, PIMAGEHLP_STATUS_ROUTINE StatusRoutine );
The bind options. This parameter can be a combination of the following values.
The name of the file to be bound. This value can be a file name, a partial path, or a full path.
The root of the search path to use if the file specified by the ImageName parameter cannot be opened.
The root of the path to search for the file's corresponding symbol file.
A pointer to a status routine. The status routine is called during the progress of the image binding. For more information, see StatusRoutine.
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.
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.
|Minimum supported client||Windows XP [desktop apps only]|
|Minimum supported server||Windows Server 2003 [desktop apps only]|