IDebugSymbols2::GetModuleNameString-Methode (dbgeng.h)

Artikel
02/26/2024

Die GetModuleNameString-Methode gibt den Namen des angegebenen Moduls zurück.

Syntax

HRESULT GetModuleNameString(
  [in]            ULONG   Which,
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PSTR    Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  NameSize
);

Parameter

[in] Which

Gibt an, welche der Namen des Moduls zurückgegeben werden sollen. Mögliche Werte sind:

Wert	BESCHREIBUNG
DEBUG_MODNAME_IMAGE	Der Name des Bilds. Dies ist der Name der ausführbaren Datei, einschließlich der Erweiterung. In der Regel ist der vollständige Pfad im Benutzermodus enthalten, aber nicht im Kernelmodus.
DEBUG_MODNAME_MODULE	Der Modulname. Dies ist in der Regel nur der Dateiname ohne die Erweiterung. In einigen Fällen unterscheidet sich der Modulname erheblich vom Dateinamen.
DEBUG_MODNAME_LOADED_IMAGE	Der Name des geladenen Images. Sofern keine Microsoft CodeView-Symbole vorhanden sind, entspricht dies dem Imagenamen.
DEBUG_MODNAME_SYMBOL_FILE	Der Name der Symboldatei. Der Pfad und Name der Symboldatei. Wenn keine Symbole geladen wurden, ist dies stattdessen der Name der ausführbaren Datei.
DEBUG_MODNAME_MAPPED_IMAGE	Der Name des zugeordneten Bilds. In den meisten Fällen ist dies NULL. Wenn der Debugger eine Bilddatei zuordnen (z. B. während des Minidumpdebuggens), ist dies der Name des zugeordneten Bilds.

[in] Index

Gibt den Index des Moduls an. Wenn er auf DEBUG_ANY_ID festgelegt ist, wird stattdessen der Base-Parameter verwendet, um den Speicherort des Moduls anzugeben.

[in] Base

Wenn Index DEBUG_ANY_ID ist, gibt den Speicherort im Speicheradressraum des Ziels der Basis des Moduls an. Andernfalls wird es ignoriert.

[out, optional] Buffer

Empfängt den Namen des Moduls. Wenn BufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Zeichen an. Diese Größe enthält den Leerraum für das "\0"-Endzeichen.

[out, optional] NameSize

Empfängt die Größe des Modulnamens in Zeichen. Diese Größe enthält den Leerraum für das "\0"-Endzeichen. Wenn NameSizeNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Die Größe des Puffers war jedoch kleiner als die Größe des Modulnamens, sodass er abgeschnitten wurde, um in den Puffer zu passen.

Hinweise

Weitere Informationen zu Modulen finden Sie unter Module.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (dbgeng.h einschließen)

Weitere Informationen

GetModuleNames

IDebugSymbols2

IDebugSymbols3