Struct winrt::hresult_error (C++/WinRT)
Tipo che rappresenta un codice di errore HRESULT.
Sintassi
struct hresult_error
Requisiti
SDK minimo supportato: Windows SDK versione 10.0.17134.0 (Windows 10, versione 1803)
Spazio dei nomi: winrt
Intestazione: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (incluso per impostazione predefinita)
Costruttori
| Costruttore | Descrizione |
|---|---|
| Costruttore hresult_error::hresult_error | Inizializza una nuova istanza dello struct hresult_error con una copia dei dati di input. |
Tipi
| Costruttore | Descrizione |
|---|---|
| tipo hresult_error::from_abi_t | Tipo del membro dati statico hresult_error::from_abi . |
Membri dati statici
| Funzione | Descrizione |
|---|---|
| membro dati statico hresult_error::from_abi | Istanza di tipo hresult_error::from_abi_t, che può essere passata al costruttore di hresult_error (o un tipo derivato) per indicare che il costruttore deve provare a recuperare informazioni sull'errore con restrizioni. |
Funzioni membro
| Funzione | Descrizione |
|---|---|
| funzione hresult_error::code | Recupera il codice per l'errore rappresentato dall'oggetto hresult_error . |
| funzione hresult_error::message | Recupera il messaggio per l'errore rappresentato dall'oggetto hresult_error . |
| funzione hresult_error::to_abi | Imposta l'oggetto informazioni sugli errori con restrizioni per il thread corrente e restituisce il codice per l'errore rappresentato dall'oggetto hresult_error . |
| funzione hresult_error::try_as | Restituisce l'interfaccia richiesta, se supportata. Restituisce nullptr, o false, se non lo è. |
Operatori membri
| Operatore | Descrizione |
|---|---|
| hresult_error::operator= (operatore di assegnazione) | Assegna un valore all'oggetto hresult_error . |
Costruttore hresult_error::hresult_error
Inizializza una nuova istanza dello struct hresult_error con una copia dei dati di input.
Sintassi
hresult_error() noexcept;
hresult_error(hresult_error&&);
hresult_error(hresult_error const& other);
explicit hresult_error(HRESULT const code) noexcept;
hresult_error(HRESULT const code, winrt::hstring const& message, ::IUnknown* object = nullptr) noexcept;
hresult_error(HRESULT const code, winrt::hresult_error::from_abi_t) noexcept;
Parametri
other Un altro hresult_error che inizializza l'oggetto hresult_error .
code Codice HRESULT che inizializza l'oggetto hresult_error .
message Stringa informativa che consente agli sviluppatori di correggere la condizione di errore segnalata.
object Oggetto errore che archivia informazioni aggiuntive sull'errore. L'oggetto errore deve essere apartment-agile, in-proc e marshalling per valore tra i processi. Deve implementare ILanguageExceptionStackBackTrace e ILanguageExceptionTransform , se necessario. Vedere RoOriginateLanguageException.
funzione hresult_error::code
Recupera il codice per l'errore rappresentato dall'oggetto hresult_error .
Sintassi
winrt::hresult code() const noexcept;
Valore restituito
Codice di errore winrt::hresult .
membro dati statico hresult_error::from_abi
Istanza di tipo hresult_error::from_abi_t, che può essere passata al costruttore di hresult_error (o un tipo derivato) per indicare che il costruttore deve provare a recuperare informazioni sull'errore con restrizioni.
Sintassi
static constexpr winrt::hresult_error::from_abi_t from_abi{};
tipo hresult_error::from_abi_t
Tipo del membro dati statico hresult_error::from_abi .
Sintassi
struct from_abi_t {};
funzione hresult_error::message
Recupera il messaggio per l'errore rappresentato dall'oggetto hresult_error .
Sintassi
winrt::hstring message() const noexcept;
Valore restituito
Winrt::hstring contenente i problemi di errore.
hresult_error::operator= (operatore di assegnazione)
Assegna un valore all'oggetto hresult_error .
Sintassi
winrt::hresult_error& operator=(winrt::hresult_error&&);
winrt::hresult_error& operator=(winrt::hresult_error const& other) noexcept;
Parametri
other Valore hresult_error da assegnare all'oggetto hresult_error .
Valore restituito
Riferimento all'oggetto hresult_error .
funzione hresult_error::to_abi
Imposta l'oggetto informazioni sugli errori con restrizioni per il thread corrente e restituisce il codice per l'errore rappresentato dall'oggetto hresult_error .
Sintassi
HRESULT to_abi() const noexcept;
Valore restituito
Codice di errore HRESULT.
funzione hresult_error::try_as
Restituisce l'interfaccia richiesta, se supportata. Restituisce nullptr se non lo è. Questa funzione è utile se si vuole eseguire una query per un'interfaccia che non è necessario tornare al chiamante. Ad esempio, è possibile recuperare un IRestrictedErrorInfo per accedere alle informazioni sugli errori con restrizioni per l'errore rappresentato dall'oggetto hresult_error .
Sintassi
template <typename To> auto try_as() const noexcept;
Parametri di modelli
typename To Tipo dell'interfaccia richiesta.
Parametri
to Riferimento a un valore per ricevere l'interfaccia richiesta.
Valore restituito
Winrt::com_ptr che fa riferimento all'interfaccia richiesta o a un puntatore intelligente fortemente tipizzato per l'interfaccia richiesta (dichiarata da C++/WinRT o da terze parti), se l'interfaccia richiesta è supportata, in caso contrario nullptr.