Функция SymSrvStoreSupplementW (dbghelp.h)
Сохраняет файл в указанном дополнении в хранилище символов. Файл обычно связан с файлом на сервере символов.
Синтаксис
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.
Администратор магазина может запретить пользователям писать дополнительные файлы, создав файл только для чтения в корне хранилища с именем Supplement. Кроме того, администратор может создать каталог дополнений и использовать списки управления доступом.
Все функции DbgHelp, такие как эта, являются однопоточными. Поэтому вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.
Чтобы вызвать версию этой функции в Юникоде, определите DBGHELP_TRANSLATE_TCHAR.
Примечание
Заголовок dbghelp.h определяет SymSrvStoreSupplement как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | dbghelp.h |
| Библиотека | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Распространяемые компоненты | DbgHelp.dll 6.3 или более поздней версии |