LOAD_DLL_DEBUG_INFO-Struktur (minwinbase.h)

Enthält Informationen zu einer DLL (Dynamic Link Library), die gerade geladen wurde.

Syntax

typedef struct _LOAD_DLL_DEBUG_INFO {
  HANDLE hFile;
  LPVOID lpBaseOfDll;
  DWORD  dwDebugInfoFileOffset;
  DWORD  nDebugInfoSize;
  LPVOID lpImageName;
  WORD   fUnicode;
} LOAD_DLL_DEBUG_INFO, *LPLOAD_DLL_DEBUG_INFO;

Members

hFile

Ein Handle für die geladene DLL. Wenn dieser Member NULL ist, ist das Handle ungültig. Andernfalls wird der Member zum Lesen und Freigeben von Lesevorgängen im Kontext des Debuggers geöffnet.

Wenn der Debugger mit dieser Datei fertig ist, sollte er das Handle mithilfe der CloseHandle-Funktion schließen.

lpBaseOfDll

Ein Zeiger auf die Basisadresse der DLL im Adressraum des Prozesses, der die DLL lädt.

dwDebugInfoFileOffset

Der Offset zu den Debuginformationen in der vom hFile-Element identifizierten Datei in Bytes. Das System erwartet, dass die Debuginformationen im CodeView 4.0-Format vorliegen. Dieses Format ist derzeit eine Ableitung des Common Object File Format (COFF).

nDebugInfoSize

Die Größe der Debuginformationen in der Datei in Bytes. Wenn dieser Member null ist, gibt es keine Debuginformationen.

lpImageName

Ein Zeiger auf den Dateinamen, der hFile zugeordnet ist. Dieser Member kann NULL sein oder die Adresse eines Zeichenfolgenzeigers im Adressraum des zu debuggenden Prozesses enthalten. Diese Adresse kann wiederum entweder NULL sein oder auf den tatsächlichen Dateinamen verweisen. Wenn fUnicode ein Wert ungleich 0 ist, lautet die Namenszeichenfolge Unicode; Andernfalls ist es ANSI.

Dieses Element ist streng optional. Debugger müssen für den Fall vorbereitet sein, dass lpImageNameNULL oder *lpImageName (im Adressraum des zu debuggenden Prozesses) NULL ist. Insbesondere stellt das System niemals einen Imagenamen für ein Create Process-Ereignis bereit, und es wird wahrscheinlich keinen Imagenamen für das erste DLL-Ereignis übergeben. Das System stellt diese Informationen auch nie im Fall von Debugereignissen bereit, die von einem Aufruf der DebugActiveProcess-Funktion stammen.

fUnicode

Ein -Wert, der angibt, ob ein von lpImageName angegebener Dateiname Unicode oder ANSI ist. Ein Wert ungleich 0 (null) für diesen Member gibt Unicode an; 0 gibt ANSI an.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	minwinbase.h (windows.h einschließen)

Weitere Informationen

CREATE_PROCESS_DEBUG_INFO

CREATE_THREAD_DEBUG_INFO

DEBUG_EVENT

DebugActiveProcess