Metodo IDebugSymbols2::GetModuleByOffset (dbgeng.h)

Articolo
02/23/2024

Il metodo GetModuleByOffset esegue la ricerca nei moduli di destinazione per uno il cui allocazione di memoria include la posizione specificata.

Sintassi

HRESULT GetModuleByOffset(
  [in]            ULONG64  Offset,
  [in]            ULONG    StartIndex,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

Parametri

[in] Offset

Specifica una posizione nello spazio indirizzi virtuale della destinazione che si trova all'interno dell'allocazione di memoria del modulo desiderato, ad esempio l'indirizzo di un simbolo appartenente al modulo.

[in] StartIndex

Specifica l'indice da cui iniziare la ricerca.

[out, optional] Index

Riceve l'indice del modulo. 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 valori di errore. Per altri dettagli, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Commenti

A partire dall'indice specificato, questo metodo restituisce il primo modulo che trova il cui intervallo di indirizzi di allocazione della memoria include la posizione specificata. Se la destinazione ha più di un modulo il cui intervallo di indirizzi di memoria include questo percorso, i moduli successivi possono essere trovati tramite chiamate ripetute a questo metodo con valori più elevati di StartIndex.

Per altre informazioni sui moduli, vedere Moduli.