Bagikan melalui

Fungsi SymSrvStoreFile (dbghelp.h)

  • Artikel

Menyimpan file di penyimpanan simbol yang ditentukan.

Sintaks

PCSTR IMAGEAPI SymSrvStoreFile(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SrvPath,
  [in]           PCSTR  File,
  [in]           DWORD  Flags
);

Parameter

[in] hProcess

Handel ke proses. Handel ini sebelumnya harus diteruskan ke fungsi SymInitialize .

[in, optional] SrvPath

Toko simbol.

[in] File

Nama file.

[in] Flags

Bendera yang mengontrol fungsi. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
SYMSTOREOPT_COMPRESS
0x01
 Kompres file.
SYMSTOREOPT_OVERWRITE
0x02
 Timpa file jika ada.
SYMSTOREOPT_PASS_IF_EXISTS
0x40
 Jangan melaporkan kesalahan jika file sudah ada di penyimpanan simbol.
SYMSTOREOPT_POINTER
0x08
 Simpan di File.ptr.
SYMSTOREOPT_RETURNINDEX
0x04
 Mengembalikan indeks saja.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah penunjuk ke string yang dihentikan null yang menentukan jalur penuh yang memenuhi syarat ke file yang disimpan.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.

Keterangan

Semua fungsi DbgHelp, seperti ini, adalah utas tunggal. Oleh karena itu, panggilan dari lebih dari satu utas ke fungsi ini kemungkinan akan mengakibatkan perilaku tak terduga atau kerusakan memori. Untuk menghindari hal ini, Anda harus menyinkronkan semua panggilan bersamaan dari lebih dari satu utas ke fungsi ini.

Fungsi ini mengembalikan penunjuk ke buffer yang mungkin digunakan kembali oleh fungsi lain. Oleh karena itu, pastikan untuk segera menyalin data yang dikembalikan ke buffer lain.

Untuk memanggil versi Unicode dari fungsi ini, tentukan DBGHELP_TRANSLATE_TCHAR.

Persyaratan

   
Target Platform Windows
Header dbghelp.h
Pustaka Dbghelp.lib
DLL Dbghelp.dll
Redistribusi DbgHelp.dll 6.3 atau yang lebih baru

Lihat juga

Fungsi DbgHelp