Metodo IDebugSymbols3::GetFunctionEntryByOffset (dbgeng.h)

Articolo
02/23/2024

Il metodo GetFunctionEntryByOffset restituisce le informazioni sulla voce di 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 un percorso nello spazio indirizzi virtuale del processo corrente dell'implementazione della funzione. Questo è il valore restituito nel parametro Offset di GetNextSymbolMatch e IDebugSymbolGroup::GetSymbolOffset e il valore del campo Offset nella struttura DEBUG_SYMBOL_ENTRY .

[in] Flags

Specifica un flag 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 ben noti. Se questo bit è impostato le voci artificiali non vengono usate.

[out, optional] Buffer

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

[in] BufferSize

Specifica le dimensioni del buffer.

[out, optional] BufferNeeded

Specifica le dimensioni delle informazioni sulla voce della funzione.

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.
S_FALSE	Il metodo ha avuto esito positivo, ma il buffer non è stato abbastanza grande per contenere le informazioni sulla voce della funzione e quindi le informazioni sono state troncate per adattarsi.
E_NOINTERFACE	Non sono state trovate informazioni sulla voce di funzione per l'offset della posizione.

Commenti

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

Nota Le funzioni in "Libreria guida immagini" e "Libreria guida 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.