Método IDebugSymbols3::GetFunctionEntryByOffset (dbgeng.h)

Artículo
02/23/2024

El método GetFunctionEntryByOffset devuelve la información de entrada de función de una función.

Sintaxis

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

Parámetros

[in] Offset

Especifica una ubicación en el espacio de direcciones virtuales del proceso actual de la implementación de la función. Este es el valor devuelto en el parámetro Offset de GetNextSymbolMatch e IDebugSymbolGroup::GetSymbolOffset y el valor del campo Offset en la estructura DEBUG_SYMBOL_ENTRY .

[in] Flags

Especifica una marca de bits que modifica el comportamiento de este método. Si no se establece el bit DEBUG_GETFNENT_RAW_ENTRY_ONLY, el motor proporcionará entradas artificiales para casos conocidos. Si este bit se establece, no se usan las entradas artificiales.

[out, optional] Buffer

Recibe la información de entrada de la función. Si el procesador efectivo es un x86, esta es la estructura FPO_DATA de la función. Para todas las demás arquitecturas, esta es la estructura de IMAGE_FUNCTION_ENTRY para esa arquitectura.

[in] BufferSize

Especifica el tamaño del búfer de búfer.

[out, optional] BufferNeeded

Especifica el tamaño de la información de entrada de función.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
S_FALSE	El método se realizó correctamente, pero el búfer no era lo suficientemente grande como para contener la información de entrada de la función, por lo que la información se truncaba para ajustarse.
E_NOINTERFACE	No se encontró información de entrada de función para el desplazamiento de ubicación.

Comentarios

Las estructuras FPO_DATA y IMAGE_FUNCTION_ENTRY se documentan en "Biblioteca de ayuda de imágenes", que se incluye en Herramientas de depuración para Windows en el archivo DbgHelp.chm.

Nota Las funciones de "Biblioteca de ayuda de imágenes" y "Biblioteca de ayuda de depuración", documentadas en DbgHelp.chm, no deben llamarse por ninguna aplicación de motor de depurador o extensión.

Para obtener más información sobre los símbolos, vea Símbolos.