Metodo IDebugSymbols3::GetModuleByModuleName (dbgeng.h)

Articolo
08/07/2023

Il metodo GetModuleByModuleName cerca i moduli di destinazione per uno con il nome specificato.

Sintassi

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

[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 degli 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 altre informazioni, 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 da chiamate ripetute a questi metodi con valori superiori di StartIndex.

Per altre informazioni sui moduli, vedere Moduli.