Platform SDK: Debugging and Error Handling

BindImage

The BindImage function computes the virtual address of each imported function.

This function has been superseded by the BindImageEx function. Use BindImageEx to provide a status routine or flags to control the image binding.

BOOL BindImage(
  PSTR ImageName,  
  PSTR DllPath,    
  PSTR SymbolPath  
);

Parameters

ImageName
[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 ImageName parameter cannot be opened.
SymbolPath
[in] Pointer to a null-terminated string that specifies the root of the path to search for the file's corresponding symbol file.

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

A call to BindImage is equivalent to the following call:

BindImageEx( 0, ImageName, DllPath, SymbolPath, NULL );

For more information, see BindImageEx.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in Imagehlp.h.
  Library: Use Imagehlp.lib.

See Also

Image Help Library Overview, ImageHlp Functions, BindImageEx