Index   Commented   Search   About

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
imagehlp.lib
Header File
imagehlp.h
Unicode
No
Platform Notes
Windows 95: IMAGEHLP is available as a redistributable.

BindImageEx

The BindImageEx function computes the virtual address of each function that is imported from all DLLs.

BOOL BindImageEx(

IN DWORD Flags,

IN LPSTR ImageName,

IN LPSTR DllPath,

IN LPSTR SymbolPath,

IN PIMAGEHLP_STATUS_ROUTINE StatusRoutine

);

Parameters

Flags

A mask of values that controls 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.
BIND_NO_UPDATE
Do not make any changes to the file.
BIND_ALL_IMAGES
Bind all images that are in the call tree for this file.

ImageName

The filename of the file to be bound. This can contain only a filename, a partial path, or a full path.

DllPath

A root path to search for ImageName if the filename contained in ImageName cannot be opened.

SymbolPath

A root path to search for the corresponding symbol file.

StatusRoutine

A pointer to a status routine. The status routine is called during the progress of the image binding.

Return Values

If the function succeeds, the return value is TRUE.

If the function fails, then 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 function that is imported from all DLLs. The computed virtual address is then saved in the importing image's Import Address Table (IAT).

The result of the process is an image that is loaded much faster because the imported functions' addresses do not have to be computed by the system loader. If an application uses many DLLs, the process of binding all the application's DLLs can significantly reduce the application load time.

The time stamp and checksum in the corresponding symbol file is updated, if the symbol file can be located.

Related Links

Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder

More Online Helps

Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages

Free Tech Secrets ;) Copyright © 2008 Free Tect Secrets ;) greatis just4fun network just4fun