Function Supersedes The Bind Image Function example essay topic

The BindImageEx function computes the virtual address of each function that is imported. This function supersedes the Bind Image function. Use BindImageEx to provide a status routine or flags to control the image binding. BOOL BindImageEx (DWORD Flags, PSTR Image Name, PSTR DllPath, PSTR Symbol Path, IMAGEHLP STATUS ROUTINE Status Routine); Parameters Flags [in] Specifies the behavior of the function. This parameter can be a combination of the following values. Value Meaning BIND NO BOUND IMPORTS Do not generate a new import address table.

Windows 95/98/Me: This flag is required. BIND NO UPDATE Do not make changes to the file. BIND ALL IMAGES Bind all images in the call tree for this file. BIND CACHE IMPORT DLLS Do not discard DLL information in the cache between calls. This improves performance when binding a large number of images.

Image Name [in] Pointer to a null-terminated string that specifies the name of the file to be bound. This value can be a file name, a partial path, or a full path. DllPath [in] Pointer to a null-terminated string that specifies the root of the search path to use if the file specified by the Image Name parameter cannot be opened. Symbol Path [in] Pointer to a null-terminated string that specifies the root of the path to search for the file's corresponding symbol file. Status Routine [in] Pointer to a status routine. The status routine is called during the progress of the image binding.

For more information, see Status Routine. Return Values 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 computer 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 Windows NT/2000/XP: Included in Windows NT 4.0 and later. Windows 95/98/Me: Included in Windows 95 and later. Header: Declared in Imagehlp. h. Library: Use Imagehlp. lib.