Metodo IDebugSymbols3::GetModuleByOffset2 (dbgeng.h)

Articolo
02/25/2024

Il metodo GetModuleByOffset2 esegue ricerche nei moduli del processo per uno il cui allocazione di memoria include la posizione specificata.

Sintassi

HRESULT GetModuleByOffset2(
  [in]            ULONG64  Offset,
  [in]            ULONG    StartIndex,
  [in]            ULONG    Flags,
  [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.

[in] Flags

Specifica un set di bit contenente le opzioni usate durante la ricerca del modulo con la posizione specificata. I flag possono contenere i flag di bit seguenti:

Contrassegno	Effetto
DEBUG_GETMOD_NO_LOADED_MODULES	Non cercare i moduli caricati.
DEBUG_GETMOD_NO_UNLOADED_MODULES	Non cercare i moduli scaricati.

[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.

Requisiti

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

Vedi anche

GetModuleByIndex

GetModuleByOffset

IDebugSymbols3

Share via