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

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

  • Статья

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

Синтаксис

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