Struct winrt::hresult_error (C++/WinRT)

  • Articolo

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.

Vedi anche