Debugging Tools for Windows

AppendImagePath

The AppendImagePath and AppendImagePathWide methods append directories to the executable image path.

IDebugSymbols::AppendImagePath(
    IN PCSTR  Addition
    );

IdebugSymbols3::AppendImagePathWide(
    IN PCWSTR  Addition
    );

#ifdef UNICODE
#define AppendImagePathT AppendImagePathWide
#else
#define AppendImagePathT AppendImagePath
#endif

Parameters

Addition
Specifies the directories to append to the executable image path. This is a string that contains directory names 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

AppendImagePath is available in all versions of IDebugSymbols. AppendImagePathWide 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, SetImagePath

Build machine: CAPEBUILD