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

Статья
08/23/2023

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

Синтаксис

PCSTR IMAGEAPI SymSrvStoreFile(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SrvPath,
  [in]           PCSTR  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.

Требования


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

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

Функции DbgHelp

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