Función SymGetLineFromInlineContextW (dbghelp.h)

Busca la línea de origen del contexto insertado especificado.

Sintaxis

BOOL IMAGEAPI SymGetLineFromInlineContextW(
  [in]           HANDLE            hProcess,
  [in]           DWORD64           dwAddr,
  [in]           ULONG             InlineContext,
  [in, optional] DWORD64           qwModuleBaseAddress,
  [out]          PDWORD            pdwDisplacement,
  [out]          PIMAGEHLP_LINEW64 Line
);

Parámetros

[in] hProcess

Identificador del proceso que se pasó originalmente a la función SymInitialize.

[in] dwAddr

Dirección para la que se debe ubicar una línea. No es necesario que la dirección esté en un límite de línea. Si la dirección aparece después del principio de una línea y antes del final de la línea, se encuentra la línea.

[in] InlineContext

Contexto insertado.

[in, optional] qwModuleBaseAddress

Dirección base del módulo.

[out] pdwDisplacement

Desplazamiento en bytes desde el principio de la línea o cero.

[out] Line

Puntero a una estructura IMAGEHLP_LINE64.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. Para recuperar información de error extendida, llame a GetLastError.

Observaciones

El autor de la llamada debe asignar correctamente el búfer line y rellenar los miembros necesarios de la estructura de IMAGEHLP_LINE64 antes de llamar a SymGetLineFromInlineContext.

Esta función devuelve un puntero a un búfer que otra función puede reutilizar. Por lo tanto, asegúrese de copiar los datos devueltos a otro búfer inmediatamente.

Todas las funciones DbgHelp, como esta, son un solo subproceso. Por lo tanto, las llamadas de más de un subproceso a esta función probablemente provocarán un comportamiento inesperado o daños en la memoria. Para evitar esto, debe sincronizar todas las llamadas simultáneas de más de un subproceso a esta función.

Para llamar a la versión Unicode de esta función, defina DBGHELP_TRANSLATE_TCHAR. SymGetLineFromInlineContext se define como se indica a continuación en Dbghelp.h.

BOOL
IMAGEAPI
SymGetLineFromInlineContextW(
    _In_ HANDLE hProcess,
    _In_ DWORD64 dwAddr,
    _In_ ULONG InlineContext,
    _In_opt_ DWORD64 qwModuleBaseAddress,
    _Out_ PDWORD pdwDisplacement,
    _Out_ PIMAGEHLP_LINEW64 Line
    );

#ifdef DBGHELP_TRANSLATE_TCHAR
 #define SymGetLineFromInlineContext SymGetLineFromInlineContextW
#endif

Nota

El encabezado dbghelp.h define SymGetLineFromInlineContext como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	dbghelp.h
biblioteca de	DbgHelp.lib
DLL de	DbgHelp.dll
redistribuible	DbgHelp.dll 6.2 o posterior