IDebugSymbols3::GetModuleByModuleName2-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetModuleByModuleName2-Methode durchsucht die Module des Prozesses nach einem Modul mit dem angegebenen Namen.

Syntax

HRESULT GetModuleByModuleName2(
  [in]            PCSTR    Name,
  [in]            ULONG    StartIndex,
  [in]            ULONG    Flags,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

Parameter

[in] Name

Gibt den Namen des gewünschten Moduls an.

[in] StartIndex

Gibt den Index an, von dem aus die Suche gestartet werden soll.

[in] Flags

Gibt einen Bitsatz an, der Optionen enthält, die bei der Suche nach dem Modul mit dem angegebenen Namen verwendet werden. Flags können die folgenden Bitflags enthalten:

Flag	Auswirkung
DEBUG_GETMOD_NO_LOADED_MODULES	Suchen Sie die geladenen Module nicht.
DEBUG_GETMOD_NO_UNLOADED_MODULES	Suchen Sie die entladenen Module nicht.

[out, optional] Index

Empfängt den Index des ersten Moduls mit dem Namen Name. Wenn IndexNULL ist, werden diese Informationen nicht zurückgegeben.

[out, optional] Base

Empfängt den Speicherort im Speicheradressraum des Ziels der Basis des Moduls. Wenn BaseNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode kann auch andere Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_INVALIDARG	Eines der übergebenen Argumente war ungültig.

Hinweise

Ab dem angegebenen Index geben diese Methoden das erste gefundene Modul mit dem angegebenen Namen zurück. Wenn das Ziel über mehrere Module mit diesem Namen verfügt, können nachfolgende Module durch wiederholte Aufrufe dieser Methoden mit höheren Werten von StartIndex gefunden werden.

Weitere Informationen zu Modulen finden Sie unter Module.

Anforderungen

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

Weitere Informationen

GetModuleByModuleName

IDebugSymbols3

Freigeben über