Função SymAddSymbol (dbghelp.h)
Adiciona um símbolo virtual ao módulo especificado.
Sintaxe
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
Um identificador para um processo. Esse identificador deve ter sido passado anteriormente para a função SymInitialize .
[in] BaseOfDll
O endereço base do módulo.
[in] Name
O nome do símbolo. O tamanho máximo de um nome de símbolo é MAX_SYM_NAME caracteres.
[in] Address
O endereço do símbolo. Esse endereço deve estar dentro do intervalo de endereços do módulo especificado.
[in] Size
O tamanho do símbolo, em bytes. Esse parâmetro é opcional.
[in] Flags
Esse parâmetro não está em uso.
Retornar valor
Se a função for bem-sucedida, o valor retornado será TRUE.
Se a função falhar, o valor retornado será FALSE. Para recuperar informações de erro estendidas, chame GetLastError.
Comentários
Todas as funções DbgHelp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.
Para chamar a versão Unicode dessa função, defina DBGHELP_TRANSLATE_TCHAR.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | dbghelp.h |
| Biblioteca | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Redistribuível | DbgHelp.dll 6.0 ou posterior |