Metodo IDebugSymbols3::GetModuleByModuleName2 (dbgeng.h)

  • Articolo

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