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

Статья
11/20/2024

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

Синтаксис

PCWSTR IMAGEAPI SymSrvStoreFileW(
  [in]           HANDLE hProcess,
  [in, optional] PCWSTR SrvPath,
  [in]           PCWSTR File,
  [in]           DWORD  Flags
);

Параметры

[in] hProcess

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

[in, optional] SrvPath

Хранилище символов.

[in] File

Имя файла.

[in] Flags

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

Ценность	Значение
SYMSTOREOPT_COMPRESS 0x01	Сжатие файла.
SYMSTOREOPT_OVERWRITE 0x02	Перезаписать файл, если он существует.
SYMSTOREOPT_PASS_IF_EXISTS 0x40	Не сообщайте об ошибке, если файл уже существует в хранилище символов.
SYMSTOREOPT_POINTER 0x08	Храните в File.ptr.
SYMSTOREOPT_RETURNINDEX 0x04	Возвращает только индекс.

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

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

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

Замечания

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

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

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

Заметка

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

Требования

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

См. также

функций DbgHelp

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