На главную

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 | Скачать Вниз

SymGetSymFromName



The SymGetSymFromName function locates a symbol for the requested name.

BOOL SymGetSymFromName(

IN HANDLE hProcess,
IN LPSTR Name,
OUT PIMAGEHLP_SYMBOL Symbol
);


Parameters

hProcess

The process handle that was originally passed to SymInitialize.

Name

The symbol name for which a symbol is requested.

Symbol

A pointer to an IMAGEHLP_SYMBOL structure.



Return Value

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 SymGetSymFromName function is used to locate a symbol for the requested name. The name can contain a module prefix that isolates the symbol search to a single module's symbol table.
The module prefix is in the form of "module!". The "!" character is the delimiter between the module name and the symbol name. If there is no module prefix, then the search is performed on each module's symbol table in a linear manner, beginning with the first module that is loaded.

Using the module prefix is preferable for two reasons. First, the symbol search occurs much faster. Second, when deferred symbol loading is turned on, the search causes symbols to be loaded for each module that is searched. When the symbol is found, the symbol information is copied into the Symbol buffer provided by the caller. The caller must allocate the Symbol buffer properly and fill in the required parameters in the IMAGEHLP_SYMBOL structure before calling the SymGetSymFromName function.


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

SymGetSymFromName



Функция SymGetSymFromName располагает символ для попрошенного имени.

BOOL SymGetSymFromName(

В РУЧКЕ hProcess, В Имени LPSTR, Символе PIMAGEHLP_SYMBOL
);


Параметры

hProcess

Ручка процесса, которая первоначально была пройдена на SymInitialize.

Имя

Символ называет в честь, которого символ требуется.

Символ

Указатель в структуру IMAGEHLP_SYMBOL.



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

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

Замечания

Функция SymGetSymFromName использована, чтобы располагать символ для запрошенного имени. Имя может содержать модульный префикс, который изолирует символьный поиск в единственную модульную символьную таблицу.
Модульный префикс - в форме "модуля!". "!" символ является разделителем между модульным именем и символьное имя. Если нет модульного префикса, тогда поиск выполнен в каждой модульной символьной таблице в линейный способ, начинающей с первого модуля, который загружен.

Использование модульного префикса предпочтительное для двух причин. Сначала, символьный поиск происходит значительно быстрее. Во-вторых, когда отложенная символьная загрузка включена, поиск вызывает символы, которые нужно загружаться для каждого модуля, который поискан. Когда символ обнаружен, символьная информация скопирована в буфер Символа предусмотренный вызывающим оператором. Вызывающий оператор должен распределить буфер Символа правильно и заполнять необходимые параметры в структуре IMAGEHLP_SYMBOL перед вызовом функции SymGetSymFromName.


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