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(
  __in          PSTR ImageName,
  __in          PSTR DllPath,
  __in          PSTR SymbolPath
);

Parameters

ImageName

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

DllPath

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

SymbolPath

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

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

A call to BindImage is equivalent to the following call: BindImageEx( 0, ImageName, DllPath, SymbolPath, NULL );

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

See Also

ImageHlp FunctionsBindImageEx

Send comments about this topic to Microsoft

Build date: 9/25/2007