На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

SymInitialize



The SymInitialize function initializes the symbol handler for a process.

BOOL SymInitialize(

IN HANDLE hProcess,
IN LPSTR UserSearchPath,
IN BOOL fInvadeProcess
);


Parameters

hProcess

Process handle for which symbols are to be maintained. If the application is a debugger, then the process handle for the object being debugged is used, otherwise GetCurrentProcess provides a valid process handle. The handle is not used as a real process handle, so any value will work as well as the next. The only limitation placed on the handle value is that it be unique for each time the application calls SymInitialize. Also, if the fInvadeProcess flag is TRUE, then the handle must be a valid process ID.

UserSearchPath

A path, or series of paths separated by a semicolon (;), that is used to search for symbol files. If a value of NULL is used, then IMAGEHLP attempts to form a symbol path from the following sources:

· Current directory
· Environment variable _NT_SYMBOL_PATH
· Environment variable _NT_ALTERNATE_SYMBOL_PATH
· Environment variable SYSTEMROOT

fInvadeProcess

If this value is TRUE, then IMAGEHLP enumerates the loaded modules for the process and effectively calls SymLoadModule for each module. In this case, the hProcess parameter must be a valid Win32 process handle.



Return Values

If the function succeeds, the return value is TRUE.
If the function fails, then the return value is FALSE. To retrieve extended error information, call GetLastError.

Remarks

The SymInitialize function is used to initialize the symbol handler for a process. In the context of the symbol handler, a process is a convenient object to use when collecting symbol information. Usually, symbol handlers are used by debuggers and other tools that need to load symbols for a process being debugged.
The process handle passed to SymInitialize can be any unique value, except in the case when fInvadeProcess is TRUE. The value passed to SymInitialize must be the same value passed to all other IMAGEHLP symbol handler functions. It is the process handle that IMAGEHLP uses to identify the caller and locate the correct symbol information. The companion function, SymCleanup, must be called to deallocate all resources associated with the process for which symbols are loaded.


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

SymInitialize



Функция SymInitialize инициализирует символьного вручителя для процесса.

BOOL SymInitialize(

В РУЧКЕ hProcess, В LPSTR UserSearchPath, В BOOL fInvadeProcess
);


Параметры

hProcess

Ручка Процесса для которой символы должны быть поддержаны. Если приложение является отладчиком, тогда ручка процесса для объекта, отлаживанного использована, в противном случае GetCurrentProcess обеспечивает правильную ручку процесса. Ручка не использована как реальная ручка процесса, так что любая величина проложит, а также другое. Единственное ограничение установленное в величине ручки - то, что это будет уникальным в течение всякий раз, когда прикладные вызовы SymInitialize. Также, если флаг fInvadeProcess является ИСТИНОЙ, тогда ручка должна быть правильным процессом ID.

UserSearchPath

Путь, или серия путей разделялись точкой с запятой (;), что использован, чтобы искать символьные файлы. Если величина НЕДЕЙСТВИТЕЛЬНАЯ использована, тогда попытки IMAGEHLP, чтобы формировать символьный путь из следующих источников:

Директорий Течения переменная Среды _NT_SYMBOL_PATH переменная Среды _NT_ALTERNATE_SYMBOL_PATH переменная Среды SYSTEMROOT

fInvadeProcess

Если эта величина является ИСТИНОЙ, тогда IMAGEHLP перечисляет загруженные модули для процесса и эффективно призывает SymLoadModule к каждому модулю. В этом случае, параметр hProcess должен быть правильной ручкой процесса Win32.



Обратные Величины

Если функция добивается успеха, обратная величина является ИСТИНОЙ.
Если функция терпит неудачу, тогда обратная величина ЛОЖНАЯ. Для того, чтобы извлекать расширенную информацию ошибки, назовите GetLastError.

Замечания

Функция SymInitialize использована, чтобы инициализировать символьного вручителя для процесса. В контексте символьного вручителя, процесс является удобным объектом против использования при сборе символьной информации. Обычно, символьные вручители использованы программами отладки и другие инструментальные средства, что нужно загружать символы для процесса, отлаживанного.
Ручка процесса пройденная на SymInitialize может быть любой уникальной величиной, за исключением случая когда fInvadeProcess - ИСТИНА. Величина пройденная на SymInitialize должна быть той же величиной пройденной во все другие символьные функции вручителя IMAGEHLP. Это - ручка процесса, что IMAGEHLP используется, чтобы идентифицировать вызывающего оператора и располагать правильную символьную информацию. Побочная функция, SymCleanup, должна быть названа, чтобы освобождать все ресурсы связанные процессом для которого символы загружены.


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz