Metodo IDebugSymbols::GetModuleByOffset (dbgeng.h)

Articolo
02/25/2024

Il metodo GetModuleByOffset esegue ricerche 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 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 valori di errore. Per altre informazioni, 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 l'intervallo di indirizzi di allocazione della memoria che 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 da chiamate ripetute a questo metodo con valori superiori di StartIndex.

Per altre informazioni sui moduli, vedere Moduli.