IDebugSymbols3::GetModuleByModuleName2Wide-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetModuleByModuleName2Wide Methode durchsucht die Module des Prozesses nach einem Mit dem angegebenen Namen.

Syntax

HRESULT GetModuleByModuleName2Wide(
  [in]            PCWSTR   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 die Suche gestartet werden soll.

[in] Flags

Gibt einen Bitsatz mit Optionen an, die beim Suchen nach dem Modul mit dem angegebenen Namen verwendet werden. Flags können die folgenden Bit-Flags enthalten:

Flagge	Effekt
DEBUG_GETMOD_NO_LOADED_MODULES	Durchsuchen Sie die geladenen Module nicht.
DEBUG_GETMOD_NO_UNLOADED_MODULES	Durchsuchen Sie die entladenen Module nicht.

[out, optional] Index

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

[out, optional] Base

Empfängt den Speicherort im Speicheradressbereich des Ziels der Basis des Moduls. Wenn Base-NULL-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.

Bemerkungen

Beginnend mit dem angegebenen Index geben diese Methoden das erste Modul zurück, das sie mit dem angegebenen Namen finden. Wenn das Ziel mehrere Module mit diesem Namen hat, 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
Header-	dbgeng.h (include Dbgeng.h)

Siehe auch

GetModuleByModuleName-

IDebugSymbols3

Freigeben über