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

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

Синтаксис

PCSTR IMAGEAPI SymSrvGetSupplement(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SymPath,
  [in]           PCSTR  Node,
  [in]           PCSTR  File
);

Параметры

[in] hProcess

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

[in, optional] SymPath

Путь к символу. Функция использует только хранилища символов, описанные в стандартном синтаксисе для хранилищ символов. Все остальные пути игнорируются. Если этот параметр имеет значение NULL, функция использует путь к символам, заданный с помощью функции SymInitialize или SymSetSearchPath .

[in] Node

Файл символов, связанный с дополнительным файлом.

[in] File

Имя файла.

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

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

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

Комментарии

Дополнительные сведения о дополнительных файлах см. в разделе SymSrvStoreSupplement.

Эта функция возвращает указатель на буфер, который может повторно использоваться другой функцией. Поэтому не забудьте немедленно скопировать данные, возвращенные в другой буфер.

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

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

Требования

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

Функции DbgHelp

SymSrvStoreSupplement