Fungsi RoCaptureErrorContext (roerrorapi.h)

Menyimpan konteks kesalahan saat ini sehingga tersedia untuk panggilan nanti ke fungsi RoFailFastWithErrorContext .

Sintaks

HRESULT RoCaptureErrorContext(
  HRESULT hr
);

Parameter

hr

HRESULT yang terkait dengan kesalahan.

Nilai kembali

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Fungsi RoCaptureErrorContext menangkap konteks yang terkait dengan kesalahan, termasuk stack-backtrace. Informasi ini disimpan dalam objek kesalahan terbatas dan tersedia untuk layanan Pelaporan Galat Windows (WER), jika WER diaktifkan, dan jika panggilan berikutnya dilakukan ke fungsi RoFailFastWithErrorContext dari utas yang sama.

Untuk menggunakan fungsi RoCaptureErrorContext dengan RoOriginateError, panggil RoOriginateError terlebih dahulu, lalu panggil RoCaptureErrorContext. Panggilan dalam urutan terbalik dapat menyebabkan konteks kesalahan hilang.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	roerrorapi.h
Pustaka	RuntimeObject.lib
DLL	ComBase.dll

Lihat juga

IRestrictedErrorInfo

RoFailFastWithErrorContext

RoOriginateError

RoOriginateErrorW