Debugging Tools for Windows

SetImagePath

The SetImagePath and SetImagePathWide methods set the executable image path.

IDebugSymbols::SetImagePath(
    IN PCSTR  Path
    );

IdebugSymbols3::SetImagePathWide(
    IN PCWSTR  Path
    );

#ifdef UNICODE
#define SetImagePathT SetImagePathWide
#else
#define SetImagePathT SetImagePath
#endif

Parameters

Path
Specifies the new executable image path. This is a string that contains directories separated by semicolons (;).

Return Value

S_OK
The method was successful.

These methods can also return error values. See Return Values for more details.

Interface Version

SetImagePath is available in all versions of IDebugSymbols. SetImagePathWide is available in IDebugSymbols3 and later versions.

Comments

The executable image path is used by the engine when searching for executable images.

The executable image path can consist of several directories separated by semicolons. These directories are searched in order.

For more information about the executable image path, see Executable Image Path.

Requirements

Headers: Defined in Dbgeng.h. Include Dbgeng.h.

See Also

GetImagePath, AppendImagePath

Build machine: CAPEBUILD