Fungsi GetRestrictedErrorInfo (roerrorapi.h)

Mendapatkan objek informasi kesalahan terbatas yang ditetapkan oleh panggilan sebelumnya ke SetRestrictedErrorInfo di utas logis saat ini.

Syntax

HRESULT GetRestrictedErrorInfo(
  [out] IRestrictedErrorInfo **ppRestrictedErrorInfo
);

Parameter-parameternya

[out] ppRestrictedErrorInfo

Objek info kesalahan terbatas yang terkait dengan utas saat ini.

Mengembalikan nilai

Fungsi ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode	Description
S_OK	Objek kesalahan terbatas berhasil diambil.
S_FALSE	Tidak ada objek kesalahan terbatas yang terkait dengan utas saat ini. Objek kesalahan lainnya dihapus dari utas.

Komentar

Panggil fungsi GetRestrictedErrorInfo untuk mendapatkan objek IRestrictedErrorInfo yang terakhir diatur pada utas saat ini di aplikasi Windows Store.

Panggil fungsi RoCaptureErrorContext untuk menyimpan informasi kesalahan untuk utas saat ini. Panggil fungsi RoFailFastWithErrorContext untuk memunculkan pengecualian, mengakhiri proses saat ini, dan melaporkan kesalahan ke layanan Pelaporan Kesalahan Windows (WER).

GetRestrictedErrorInfo mentransfer kepemilikan objek kesalahan ke pemanggil dan menghapus status kesalahan untuk utas. Jika objek kesalahan yang terakhir diatur tidak mendukung antarmuka IRestrictedErrorInfo , status kesalahan untuk utas dihapus, tetapi tidak ada antarmuka yang dikembalikan ke pemanggil.

GetRestrictedErrorInfo mengambil objek kesalahan dari utas saat ini dan memanggil QueryInterface untuk menemukan antarmuka IRestrictedErrorInfo. Jika IRestrictedErrorInfo tidak ditemukan, GetRestrictedErrorInfo mengembalikan S_FALSE. Dalam hal ini, objek kesalahan dihapus dari utas. Untuk informasi selengkapnya, lihat GetErrorInfo.

Memanggil fungsi GetRestrictedErrorInfo gagal jika IRestrictedErrorInfo bukan implementasi sistem. Untuk membuat objek IRestrictedErrorInfo , panggil fungsi OriginateError, TransformError, atau RoCaptureErrorContext .

Persyaratan

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

Lihat juga

GetErrorInfo

IRestrictedErrorInfo

RO_ERROR_REPORTING_FLAGS

RoCaptureErrorContext

RoFailFastWithErrorContext

SetRestrictedErrorInfo