Fungsi WerRegisterMemoryBlock (werapi.h)

Mendaftarkan blok memori yang akan dikumpulkan ketika Pelaporan Galat Windows (WER) membuat laporan kesalahan.

Sintaks

HRESULT WerRegisterMemoryBlock(
  [in] PVOID pvAddress,
  [in] DWORD dwSize
);

Parameter

[in] pvAddress

Alamat awal blok memori.

[in] dwSize

Ukuran blok memori, dalam byte. Nilai maksimum untuk parameter ini adalah WER_MAX_MEM_BLOCK_SIZE byte.

Mengembalikan nilai

Fungsi ini mengembalikan S_OK pada keberhasilan atau kode kesalahan pada kegagalan, termasuk kode kesalahan berikut.

Menampilkan kode	Deskripsi
WER_E_INVALID_STATE	Status proses tidak valid. Misalnya, prosesnya dalam mode pemulihan aplikasi.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Jumlah blok memori dan file terdaftar melebihi batas.

Keterangan

Memori yang terdaftar dengan fungsi ini hanya ditambahkan ke file cadangan heap atau yang lebih besar. Memori ini tidak pernah ditambahkan ke cadangan mini atau file cadangan yang lebih kecil.

Untuk crash dan tidak ada respons, sistem operasi secara otomatis menyediakan pelaporan kesalahan (Anda tidak perlu memberikan kode pelaporan kesalahan apa pun di aplikasi Anda). Jika Anda menggunakan fungsi ini untuk mendaftarkan blok memori, sistem operasi akan menambahkan informasi blok memori ke file cadangan pada saat crash atau non-respons. Blok memori ditambahkan ke file cadangan untuk laporan hanya ketika data tambahan diminta oleh server.

Untuk pelaporan peristiwa generik, aplikasi harus memanggil fungsi pelaporan peristiwa generik WER secara langsung. Untuk menambahkan blok memori ke laporan generik, panggil fungsi WerReportAddDump lalu panggil fungsi WerReportSubmit dan tentukan bendera WER_SUBMIT_ADD_REGISTERED_DATA.

Untuk menghapus blok dari daftar ini, panggil fungsi WerUnregisterMemoryBlock .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	werapi.h
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

WerUnregisterMemoryBlock, Pelaporan Galat Windows