IDebugSymbols2::GetModuleNameString-Methode (dbgeng.h)

Artikel
02/06/2025

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 Namen des Moduls zurückgegeben werden sollen, mögliche Werte sind:

Wert	Beschreibung
DEBUG_MODNAME_IMAGE	Der Bildname. Dies ist der Name der ausführbaren Datei, einschließlich der Erweiterung. Normalerweise 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 geladene Bildname. Sofern keine Microsoft CodeView-Symbole vorhanden sind, entspricht dies dem Bildnamen.
DEBUG_MODNAME_SYMBOL_FILE	Der Symboldateiname. Der Pfad und der Name der Symboldatei. Wenn keine Symbole geladen wurden, ist dies der Name der ausführbaren Datei.
DEBUG_MODNAME_MAPPED_IMAGE	Der zugeordnete Bildname. In den meisten Fällen ist dies NULL-. Wenn der Debugger eine Bilddatei zuordnen soll (z. B. während des Minidump-Debuggings), ist dies der Name des zugeordneten Bilds.

[in] Index

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

[in] Base

Wenn Index- DEBUG_ANY_ID ist, gibt die Position im Speicheradressbereich des Ziels der Basis des Moduls an. Andernfalls wird sie ignoriert.

[out, optional] Buffer

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

[in] BufferSize

Gibt die Größe in Zeichen des Puffers Puffer-an. Diese Größe enthält den Abstand für das Endzeichen '\0'.

[out, optional] NameSize

Empfängt die Größe in Zeichen des Modulnamens. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn NameSize-NULL-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, damit er in den Puffer passt.

Bemerkungen

Weitere Informationen zu Modulen finden Sie unter Module.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Siehe auch

GetModuleNames-

IDebugSymbols2

IDebugSymbols3

Freigeben über