Compartir a través de

Función SymSetContext (dbghelp.h)

  • Artículo

Establece la información de contexto usada por la función SymEnumSymbols . Esta función solo funciona con símbolos PDB.

Sintaxis

BOOL IMAGEAPI SymSetContext(
  [in]           HANDLE                hProcess,
  [in]           PIMAGEHLP_STACK_FRAME StackFrame,
  [in, optional] PIMAGEHLP_CONTEXT     Context
);

Parámetros

[in] hProcess

Identificador de un proceso. Este identificador debe haberse pasado previamente a la función SymInitialize .

[in] StackFrame

Puntero a una estructura de IMAGEHLP_STACK_FRAME que contiene información de fotogramas.

[in, optional] Context

Este parámetro se ignora.

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.

Comentarios

Si llama a SymSetContext para establecer el contexto en su valor actual, se produce un error en la función, pero GetLastError devuelve ERROR_SUCCESS.

Todas las funciones DbgHelp, como esta, son un único subproceso. Por lo tanto, es probable que las llamadas desde más de un subproceso a esta función producirán un comportamiento inesperado o daños en la memoria. Para evitarlo, debe sincronizar todas las llamadas simultáneas de más de un subproceso a esta función.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado dbghelp.h
Library Dbghelp.lib
Archivo DLL Dbghelp.dll
Redistribuible DbgHelp.dll 5.1 o posterior

Consulte también

Funciones de DbgHelp

IMAGEHLP_STACK_FRAME

SymEnumSymbols