IDebugSymbols3::GetModuleNameStringWide-Methode (dbgeng.h)

Artikel
02/26/2024

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

Syntax

HRESULT GetModuleNameStringWide(
  [in]            ULONG   Which,
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PWSTR   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 Bilds. Sofern keine Microsoft CodeView-Symbole vorhanden sind, ist dies mit dem Imagenamen identisch.
DEBUG_MODNAME_SYMBOL_FILE	Der Name der Symboldatei. Pfad und Name der Symboldatei. Wenn keine Symbole geladen wurden, ist dies stattdessen der Name der ausführbaren Datei.
DEBUG_MODNAME_MAPPED_IMAGE	Der zugeordnete Imagename. In den meisten Fällen ist dies NULL. Wenn der Debugger eine Imagedatei zuordnen (z. B. beim Debuggen von Minidump), ist dies der Name des zugeordneten Images.

[in] Index

Gibt den Index des Moduls an. Wenn sie auf DEBUG_ANY_ID festgelegt ist, wird der Base-Parameter verwendet, um stattdessen 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 sie ignoriert.

[out, optional] Buffer

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

[in] BufferSize

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

[out, optional] NameSize

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

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. 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 (einschließlich Dbgeng.h)

Weitere Informationen

GetModuleNames

IDebugSymbols3