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

Tipo che rappresenta un codice di errore HRESULT.A type representing an HRESULT error code.

SintassiSyntax

struct hresult_error

RequisitiRequirements

SDK minimo supportato: Windows SDK versione 10.0.17134.0 (Windows 10, versione 1803)Minimum supported SDK: Windows SDK version 10.0.17134.0 (Windows 10, version 1803)

Spazio dei nomi: WinRTNamespace: winrt

L' intestazione % WindowsSdkDir% include <WindowsTargetPlatformVersion> \cppwinrt\winrt\base.h (incluso per impostazione predefinita)Header %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (included by default)

CostruttoriConstructors

CostruttoreConstructor DescrizioneDescription
Costruttore hresult_error:: hresult_errorhresult_error::hresult_error constructor Inizializza una nuova istanza della struttura hresult_error con una copia dei dati di input.Initializes a new instance of the hresult_error struct with a copy of the input data.

TipiTypes

CostruttoreConstructor DescrizioneDescription
tipo hresult_error:: from_abi_thresult_error::from_abi_t type Tipo del membro dati statico hresult_error:: from_abi .The type of the hresult_error::from_abi static data member.

Membri dati staticiStatic data members

FunzioneFunction DescrizioneDescription
membro dati statico hresult_error:: from_abihresult_error::from_abi static data member 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 le informazioni sull'errore limitate.An instance of type hresult_error::from_abi_t, which can be passed to the constructor of hresult_error (or a derived type) to indicate that the constructor should try to retrieve restricted error info.

Funzioni membroMember functions

FunzioneFunction DescrizioneDescription
funzione hresult_error:: codehresult_error::code function Recupera il codice per l'errore rappresentato dall'oggetto hresult_error .Retrieves the code for the error represented by the hresult_error object.
funzione hresult_error:: Messagehresult_error::message function Recupera il messaggio per l'errore rappresentato dall'oggetto hresult_error .Retrieves the message for the error represented by the hresult_error object.
funzione hresult_error:: to_abihresult_error::to_abi function Imposta l'oggetto informazioni sull'errore limitato per il thread corrente e restituisce il codice per l'errore rappresentato dall'oggetto hresult_error .Sets the restricted error information object for the current thread, and returns the code for the error represented by the hresult_error object.
funzione hresult_error:: try_ashresult_error::try_as function Restituisce l'interfaccia richiesta, se supportata.Returns the requested interface, if it is supported. Restituisce nullptr oppure false , in caso contrario.Returns nullptr, or false, if it is not.

Operatori membroMember operators

OperatoreOperator DescrizioneDescription
hresult_error:: operator = (operatore di assegnazione)hresult_error::operator= (assignment operator) Assegna un valore all'oggetto hresult_error .Assigns a value to the hresult_error object.

Costruttore hresult_error:: hresult_errorhresult_error::hresult_error constructor

Inizializza una nuova istanza della struttura hresult_error con una copia dei dati di input.Initializes a new instance of the hresult_error struct with a copy of the input data.

SintassiSyntax

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;

ParametriParameters

other Un altro hresult_error che Inizializza l'oggetto hresult_error .other Another hresult_error that initializes the hresult_error object.

code Codice HRESULT che Inizializza l'oggetto hresult_error .code An HRESULT code that initializes the hresult_error object.

message Stringa informativa che consente agli sviluppatori di correggere la condizione di errore indicata.message An informative string to help developers to correct the reported error condition.

object Oggetto Error che archivia informazioni aggiuntive sull'errore.object An error object that stores extra information about the error. L'oggetto Error deve essere Apartment-agile, in-process e Marshal-by-value nei processi.The error object should be apartment-agile, in-proc, and marshal-by-value across processes. Se necessario, deve implementare ILanguageExceptionStackBackTrace e ILanguageExceptionTransform .It should implement ILanguageExceptionStackBackTrace and ILanguageExceptionTransform if necessary. Vedere RoOriginateLanguageException.See RoOriginateLanguageException.

funzione hresult_error:: codehresult_error::code function

Recupera il codice per l'errore rappresentato dall'oggetto hresult_error .Retrieves the code for the error represented by the hresult_error object.

SintassiSyntax

winrt::hresult code() const noexcept;

Valore restituitoReturn value

Codice di errore WinRT:: HRESULT .A winrt::hresult error code.

membro dati statico hresult_error:: from_abihresult_error::from_abi static data member

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 le informazioni sull'errore limitate.An instance of type hresult_error::from_abi_t, which can be passed to the constructor of hresult_error (or a derived type) to indicate that the constructor should try to retrieve restricted error info.

SintassiSyntax

static constexpr winrt::hresult_error::from_abi_t from_abi{};

tipo hresult_error:: from_abi_thresult_error::from_abi_t type

Tipo del membro dati statico hresult_error:: from_abi .The type of the hresult_error::from_abi static data member.

SintassiSyntax

struct from_abi_t {};

funzione hresult_error:: Messagehresult_error::message function

Recupera il messaggio per l'errore rappresentato dall'oggetto hresult_error .Retrieves the message for the error represented by the hresult_error object.

SintassiSyntax

winrt::hstring message() const noexcept;

Valore restituitoReturn value

Oggetto WinRT:: HString contenente l'errore messaggio.A winrt::hstring containing the error messsage.

hresult_error:: operator = (operatore di assegnazione)hresult_error::operator= (assignment operator)

Assegna un valore all'oggetto hresult_error .Assigns a value to the hresult_error object.

SintassiSyntax

winrt::hresult_error& operator=(winrt::hresult_error&&);
winrt::hresult_error& operator=(winrt::hresult_error const& other) noexcept;

ParametriParameters

other Valore hresult_error da assegnare all'oggetto hresult_error .other An hresult_error value to assign to the hresult_error object.

Valore restituitoReturn value

Riferimento all'oggetto hresult_error .A reference to the hresult_error object.

funzione hresult_error:: to_abihresult_error::to_abi function

Imposta l'oggetto informazioni sull'errore limitato per il thread corrente e restituisce il codice per l'errore rappresentato dall'oggetto hresult_error .Sets the restricted error information object for the current thread, and returns the code for the error represented by the hresult_error object.

SintassiSyntax

HRESULT to_abi() const noexcept;

Valore restituitoReturn value

Codice di errore HRESULT.An HRESULT error code.

funzione hresult_error:: try_ashresult_error::try_as function

Restituisce l'interfaccia richiesta, se supportata.Returns the requested interface, if it is supported. Restituisce in nullptr caso contrario.Returns nullptr if it is not. Questa funzione è utile se si desidera eseguire una query per un'interfaccia che non è necessario passare di nuovo al chiamante.This function is useful if you want to query for an interface that you don't need to pass back to your caller. Ad esempio, è possibile recuperare un IRestrictedErrorInfo per accedere alle informazioni sull'errore limitate per l'errore rappresentato dall'oggetto hresult_error .For example, you can retrieve an IRestrictedErrorInfo to access the restricted error info for the error represented by the hresult_error object.

SintassiSyntax

template <typename To> auto try_as() const noexcept;

Parametri di modelliTemplate parameters

typename To Tipo dell'interfaccia richiesta.typename To The type of the requested interface.

ParametriParameters

to Riferimento a un valore per la ricezione dell'interfaccia richiesta.to A reference to a value to receive the requested interface.

Valore restituitoReturn value

Oggetto 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 .A winrt::com_ptr referencing the requested interface, or a strongly-typed smart pointer for the requested interface (either declared by C++/WinRT or by a third party), if the requested interface is supported, otherwise nullptr.

Vedi ancheSee also