Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

LOADED_IMAGE structure (dbghelp.h)

Contains information about the loaded image.

Syntax

typedef struct _LOADED_IMAGE {
 PSTR ModuleName;
 HANDLE hFile;
 PUCHAR MappedAddress;
#if ...
 PIMAGE_NT_HEADERS64 FileHeader;
#else
 PIMAGE_NT_HEADERS32 FileHeader;
#endif
 PIMAGE_SECTION_HEADER LastRvaSection;
 ULONG NumberOfSections;
 PIMAGE_SECTION_HEADER Sections;
 ULONG Characteristics;
 BOOLEAN fSystemImage;
 BOOLEAN fDOSImage;
 BOOLEAN fReadOnly;
 UCHAR Version;
 LIST_ENTRY Links;
 ULONG SizeOfImage;
} LOADED_IMAGE, *PLOADED_IMAGE;

Members

ModuleName

The file name of the mapped file.

hFile

A handle to the mapped file.

MappedAddress

The base address of the mapped file.

FileHeader

A pointer to an IMAGE_NT_HEADERS structure.

LastRvaSection

A pointer to an IMAGE_SECTION_HEADER structure.

NumberOfSections

The number of COFF section headers.

Sections

A pointer to an IMAGE_SECTION_HEADER structure.

Characteristics

The image characteristics value. This member can be one of the following values.

Value Meaning
IMAGE_FILE_RELOCS_STRIPPED
0x0001
 Relocation information is stripped from the file.
IMAGE_FILE_EXECUTABLE_IMAGE
0x0002
 The file is executable (there are no unresolved external references).
IMAGE_FILE_LINE_NUMS_STRIPPED
0x0004
 Line numbers are stripped from the file.
IMAGE_FILE_LOCAL_SYMS_STRIPPED
0x0008
 Local symbols are stripped from file.
IMAGE_FILE_AGGRESIVE_WS_TRIM
0x0010
 Aggressively trim the working set.
IMAGE_FILE_LARGE_ADDRESS_AWARE
0x0020
 The application can handle addresses larger than 2 GB.
IMAGE_FILE_BYTES_REVERSED_LO
0x0080
 Bytes of word are reversed.
IMAGE_FILE_32BIT_MACHINE
0x0100
 Computer supports 32-bit words.
IMAGE_FILE_DEBUG_STRIPPED
0x0200
 Debugging information is stored separately in a .dbg file.
IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP
0x0400
 If the image is on removable media, copy and run from the swap file.
IMAGE_FILE_NET_RUN_FROM_SWAP
0x0800
 If the image is on the network, copy and run from the swap file.
IMAGE_FILE_SYSTEM
0x1000
 System file.
IMAGE_FILE_DLL
0x2000
 DLL file.
IMAGE_FILE_UP_SYSTEM_ONLY
0x4000
 File should be run only on a uniprocessor computer.
IMAGE_FILE_BYTES_REVERSED_HI
0x8000
 Bytes of the word are reversed.

fSystemImage

If the image is a kernel mode executable image, this value is TRUE.

fDOSImage

If the image is a 16-bit executable image, this value is TRUE.

fReadOnly

If the image is read-only, this value is TRUE.

Prior to Windows Vista:  This member is not included in the structure.

Version

The version string.

Prior to Windows Vista:  This member is not included in the structure.

Links

The list of loaded images.

SizeOfImage

The size of the image, in bytes.

Remarks

The LIST_ENTRY structure is defined as follows:

typedef struct _LIST_ENTRY {
 struct _LIST_ENTRY *Flink;
 struct _LIST_ENTRY *Blink;
} LIST_ENTRY, *PLIST_ENTRY, *RESTRICTED_POINTER PRLIST_ENTRY;

Requirements

Requirement Value
Header dbghelp.h
Redistributable DbgHelp.dll 5.1 or later

See also

IMAGE_NT_HEADERS

IMAGE_SECTION_HEADER

ImageLoad

MapAndLoad

Feedback

Was this page helpful?

Additional resources

  • Last updated on