Metodo IDebugSymbols3::GetModuleByModuleName2 (dbgeng.h)

Il metodo GetModuleByModuleName2 cerca uno dei moduli del processo con il nome specificato.

Sintassi

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

Parametri

[in] Name

Specifica il nome del modulo desiderato.

[in] StartIndex

Specifica l'indice da cui iniziare la ricerca.

[in] Flags

Specifica un set di bit contenente le opzioni utilizzate durante la ricerca del modulo con il nome specificato. I flag possono contenere i flag di bit seguenti:

Contrassegno	Effetto
DEBUG_GETMOD_NO_LOADED_MODULES	Non eseguire ricerche nei moduli caricati.
DEBUG_GETMOD_NO_UNLOADED_MODULES	Non eseguire ricerche nei moduli scaricati.

[out, optional] Index

Riceve l'indice del primo modulo con il nome Name. Se Index è NULL, queste informazioni non vengono restituite.

[out, optional] Base

Riceve la posizione nello spazio indirizzi di memoria della destinazione della base del modulo. Se Base è NULL, queste informazioni non vengono restituite.

Valore restituito

Questo metodo può anche restituire altri valori di errore. Per altri dettagli, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_INVALIDARG	Uno degli argomenti passati non è valido.

Commenti

A partire dall'indice specificato, questi metodi restituiscono il primo modulo trovato con il nome specificato. Se la destinazione ha più di un modulo con questo nome, i moduli successivi possono essere trovati tramite chiamate ripetute a questi metodi con valori più elevati di StartIndex.

Per altre informazioni sui moduli, vedere Moduli.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dbgeng.h (include Dbgeng.h)

Vedi anche

GetModuleByModuleName

IDebugSymbols3