Fungsi SymSrvStoreSupplement (dbghelp.h)

Menyimpan file dalam suplemen yang ditentukan ke penyimpanan simbol. File biasanya dikaitkan dengan file di server simbol.

Sintaks

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

Parameter

[in] hProcess

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

[in, optional] SrvPath

Jalur ke penyimpanan simbol.

[in] Node

File simbol yang terkait dengan file tambahan.

[in] File

Nama file.

[in] Flags

Jika parameter ini SYMSTOREOPT_COMPRESS, file dikompresi di penyimpanan simbol. Saat ini, tidak ada nilai lain yang didukung.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian adalah jalur yang sepenuhnya memenuhi syarat untuk file tambahan.

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

Keterangan

Penggunaan penting untuk fungsi ini adalah menyimpan file delta. Untuk informasi selengkapnya, lihat SymSrvDeltaName.

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.

Server simbol menyimpan file tambahan dengan ekstensi yang sama dalam direktori umum. Misalnya, Sup1.xml akan disimpan di direktori berikut: SymPath\supplement\Node\xml.

Administrator toko dapat mencegah pengguna menulis file tambahan dengan membuat file baca-saja di akar toko bernama Suplemen. Atau, administrator dapat membuat direktori tambahan dan menggunakan ACL untuk mengontrol akses.

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.

Untuk memanggil versi Unicode dari fungsi ini, tentukan DBGHELP_TRANSLATE_TCHAR.

Persyaratan

Persyaratan	Nilai
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

SymSrvGetSupplement