Поделиться через


Функция SymGetSourceFileToken (dbghelp.h)

Извлекает маркер для указанного исходного файла с исходного сервера.

Синтаксис

BOOL IMAGEAPI SymGetSourceFileToken(
  [in]  HANDLE  hProcess,
  [in]  ULONG64 Base,
  [in]  PCSTR   FileSpec,
  [out] PVOID   *Token,
  [out] DWORD   *Size
);

Параметры

[in] hProcess

Дескриптор процесса. Этот дескриптор должен быть ранее передан в функцию SymInitialize .

[in] Base

Базовый адрес модуля.

[in] FileSpec

Имя исходного файла.

[out] Token

Указатель на буфер, получающий маркер.

[out] Size

Размер буфера маркеров в байтах.

Возвращаемое значение

Если функция выполняется успешно, возвращается значение TRUE.

Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.

Комментарии

Все функции DbgHelp, такие как эта, являются однопоточными. Поэтому вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.

Чтобы вызвать версию этой функции в Юникоде, определите DBGHELP_TRANSLATE_TCHAR.

Требования

Требование Значение
Целевая платформа Windows
Header dbghelp.h
Библиотека Dbghelp.lib
DLL Dbghelp.dll
Распространяемые компоненты DbgHelp.dll 6.2 или более поздней версии

См. также раздел

Функции DbgHelp

Исходный сервер