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

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

  • Статья

Извлекает строку индекса для указанного файла PDB, DBG или файла образа.

Синтаксис

BOOL IMAGEAPI SymSrvGetFileIndexStringW(
  [in]           HANDLE hProcess,
  [in, optional] PCWSTR SrvPath,
  [in]           PCWSTR File,
  [out]          PWSTR  Index,
  [in]           size_t Size,
  [in]           DWORD  Flags
);

Параметры

[in] hProcess

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

[in, optional] SrvPath

Путь к серверу символов.

[in] File

Имя файла.

[out] Index

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

[in] Size

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

[in] Flags

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

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

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

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

Комментарии

Эта функция не предназначена для общего использования. Те, кто пишет служебные программы для управления файлами в хранилищах сервера символов, могут использовать эту функцию для прогнозирования относительного пути, который сервер символов будет искать для файла. Он используется srctool.exe для фактического заполнения хранилищ сервера символов.

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

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

Примечание

Заголовок dbghelp.h определяет SymSrvGetFileIndexString как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

Функции DbgHelp