Metodo IDebugSymbols3::GetFunctionEntryByOffset (dbgeng.h)

Articolo
02/06/2025

Il metodo GetFunctionEntryByOffset restituisce le informazioni sulla voce della funzione per una funzione.

Sintassi

HRESULT GetFunctionEntryByOffset(
  [in]            ULONG64 Offset,
  [in]            ULONG   Flags,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BufferNeeded
);

Parametri

[in] Offset

Specifica una posizione nello spazio indirizzi virtuale del processo corrente dell'implementazione della funzione. Questo è il valore restituito nel parametro offset di GetNextSymbolMatch e IDebugSymbolGroup::GetSymbolOffsete il valore del campo offset nella struttura DEBUG_SYMBOL_ENTRY.

[in] Flags

Specifica un flag di bit che modifica il comportamento di questo metodo. Se il bit DEBUG_GETFNENT_RAW_ENTRY_ONLY non è impostato, il motore fornirà voci artificiali per casi noti. Se questo bit è impostato, le voci artificiali non vengono utilizzate.

[out, optional] Buffer

Riceve le informazioni sulla voce della funzione. Se il processore effettivo è un x86, si tratta della struttura FPO_DATA per la funzione. Per tutte le altre architetture, si tratta della struttura IMAGE_FUNCTION_ENTRY per tale architettura.

[in] BufferSize

Specifica le dimensioni del buffer Buffer.

[out, optional] BufferNeeded

Specifica le dimensioni delle informazioni sulla voce della funzione.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
S_FALSE	Il metodo ha avuto esito positivo, ma il buffer non era sufficientemente grande da contenere le informazioni di immissione della funzione e quindi le informazioni sono state troncate per adattarsi.
E_NOINTERFACE	Non sono state trovate informazioni sulla voce di funzione per la posizione Offset.

Osservazioni

Le strutture FPO_DATA e IMAGE_FUNCTION_ENTRY sono documentate in "Raccolta guida immagini" inclusa in Strumenti di debug per Windows nel file DbgHelp.chm.

Nota Le funzioni in "Raccolta guida immagini" e "Libreria della Guida di debug", documentate in DbgHelp.chm, non devono essere chiamate da alcuna applicazione del motore di estensione o debugger.

Per altre informazioni sui simboli, vedere Simboli.