winrt::throw_hresult-Funktion (C++/WinRT)

Eine Hilfsfunktion, die einen HRESULT-Fehlercode verwendet und eine Ausnahme mithilfe eines C++/WinRT-Objekts (oder eines Standardobjekts) auslöst, das diesen Fehlercode darstellt.

Wenn der Fehlercode E_OUTOFMEMORY ist, wird std::bad_alloc ausgelöst. Wenn der Fehlercode ein häufiger HRESULT-Fehlercode ist, wird einer der spezialisierten Typen ausgelöst, die von winrt::hresult_error abgeleitet werden. Beispielsweise bewirkt E_INVALIDARG, dass eine winrt::hresult_invalid_argument ausgelöst wird. Andernfalls wird winrt::hresult_error ausgelöst.

Syntax

[[noreturn]] inline __declspec(noinline) void throw_hresult(HRESULT const result);

Parameter

result Ein HRESULT-Code, der den aufgetretenen Fehler darstellt.

Anforderungen

Mindestens unterstütztes SDK: Windows SDK-Version 10.0.17134.0 (Windows 10, Version 1803)

Namespace: winrt

Header: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (standardmäßig enthalten)

Siehe auch

• winrt-Namespace
• winrt::hresult_error-Struktur
• Fehlerbehandlung bei C++/WinRT
• Worin besteht der Unterschied zwischen dem Auslösen einer winrt::hresult_error und der Verwendung von winrt::throw_hresult?