Функция SymAddSymbol (dbghelp.h)
Добавляет виртуальный символ в указанный модуль.
Синтаксис
BOOL IMAGEAPI SymAddSymbol(
[in] HANDLE hProcess,
[in] ULONG64 BaseOfDll,
[in] PCSTR Name,
[in] DWORD64 Address,
[in] DWORD Size,
[in] DWORD Flags
);
Параметры
[in] hProcess
Дескриптор процесса. Этот дескриптор должен быть ранее передан в функцию SymInitialize .
[in] BaseOfDll
Базовый адрес модуля.
[in] Name
Имя символа. Максимальный размер имени символа — MAX_SYM_NAME символов.
[in] Address
Адрес символа. Этот адрес должен находиться в диапазоне адресов указанного модуля.
[in] Size
Размер символа в байтах. Этот параметр является необязательным.
[in] Flags
Этот параметр не используется.
Возвращаемое значение
Если функция выполняется успешно, возвращается значение TRUE.
Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.
Комментарии
Все функции DbgHelp, такие как эта, являются однопоточными. Поэтому вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.
Чтобы вызвать версию этой функции в Юникоде, определите DBGHELP_TRANSLATE_TCHAR.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | dbghelp.h |
| Библиотека | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Распространяемые компоненты | DbgHelp.dll 6.0 или более поздней версии |