IDebugSymbols3::GetModuleByModuleName-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetModuleByModuleName-Methode durchsucht die Module des Ziels nach einem Modul mit dem angegebenen Namen.

Syntax

HRESULT GetModuleByModuleName(
  [in]            PCSTR    Name,
  [in]            ULONG    StartIndex,
  [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.

[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 gibt möglicherweise auch andere Fehlerwerte zurück. 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.