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


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

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

Синтаксис

BOOL IMAGEAPI SymGetSourceFileFromToken(
  [in]           HANDLE hProcess,
  [in]           PVOID  Token,
  [in, optional] PCSTR  Params,
  [out]          PSTR   FilePath,
  [in]           DWORD  Size
);

Параметры

[in] hProcess

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

[in] Token

Указатель на маркер.

[in, optional] Params

Этот параметр не используется.

[out] FilePath

Указатель на буфер, который получает полный путь к исходному файлу.

[in] Size

Размер буфера FilePath в символах.

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

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

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

Комментарии

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

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

Требования

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

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

Функции DbgHelp

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