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

Статья
11/20/2024

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

Синтаксис

PCWSTR IMAGEAPI SymSrvStoreSupplementW(
  [in]           HANDLE hProcess,
  [in, optional] PCWSTR SymPath,
  [in]           PCWSTR Node,
  [in]           PCWSTR File,
  [in]           DWORD  Flags
);

Параметры

[in] hProcess

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

[in, optional] SymPath

Путь к хранилищу символов.

[in] Node

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

[in] File

Имя файла.

[in] Flags

Если этот параметр SYMSTOREOPT_COMPRESS, файл сжимается в хранилище символов. В настоящее время нет других поддерживаемых значений.

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

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

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

Замечания

Важно использовать эту функцию для хранения разностных файлов. Дополнительные сведения см. в разделе SymSrvDeltaName.

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

Сервер символов хранит дополнительные файлы с тем же расширением в общем каталоге. Например, Sup1.xml будут храниться в следующем каталоге: SymPath\supplement\Node\xml.

Администратор хранилища может запретить пользователям писать дополнительные файлы, создав файл только для чтения в корне хранилища с именем "Дополнение". Кроме того, администратор может создать каталог дополнения и использовать списки управления доступом.

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

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

Заметка

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

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	dbghelp.h
библиотеки	Dbghelp.lib
DLL	Dbghelp.dll
распространяемый	DbgHelp.dll 6.3 или более поздней версии

См. также

функций DbgHelp

SymSrvGetSupplement

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