Compartir a través de


Función SymAddSymbol (dbghelp.h)

Agrega un símbolo virtual al módulo especificado.

Sintaxis

BOOL IMAGEAPI SymAddSymbol(
  [in] HANDLE  hProcess,
  [in] ULONG64 BaseOfDll,
  [in] PCSTR   Name,
  [in] DWORD64 Address,
  [in] DWORD   Size,
  [in] DWORD   Flags
);

Parámetros

[in] hProcess

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

[in] BaseOfDll

Dirección base del módulo.

[in] Name

Nombre del símbolo. El tamaño máximo de un nombre de símbolo es MAX_SYM_NAME caracteres.

[in] Address

Dirección del símbolo. Esta dirección debe estar dentro del intervalo de direcciones del módulo especificado.

[in] Size

Tamaño del símbolo, en bytes. Este parámetro es opcional.

[in] Flags

Este parámetro no se utiliza.

Valor devuelto

Si la función se realiza 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

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.

Para llamar a la versión Unicode de esta función, defina DBGHELP_TRANSLATE_TCHAR.

Requisitos

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

Consulte también

Funciones de DbgHelp

SymDeleteSymbol