winrt:: hresult_error 구조체 (C++/winrt)winrt::hresult_error struct (C++/WinRT)

HRESULT 오류 코드를 나타내는 형식입니다.A type representing an HRESULT error code.

구문Syntax

struct hresult_error

요구 사항Requirements

지원 되는 최소 SDK: Windows SDK 버전 10.0.17134.0 (Windows 10, 버전 1803)Minimum supported SDK: Windows SDK version 10.0.17134.0 (Windows 10, version 1803)

네임 스페이스: winrtNamespace: winrt

헤더 % windowssdkdir% 포함<Windowssdkdir > \cppwinrt\winrt\base.h (기본적으로 포함 됨)Header %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (included by default)

생성자Constructors

생성자Constructor 설명Description
hresult_error:: hresult_error 생성자hresult_error::hresult_error constructor 입력 데이터의 복사본을 사용 하 여 hresult_error 구조체의 새 인스턴스를 초기화 합니다.Initializes a new instance of the hresult_error struct with a copy of the input data.

형식Types

생성자Constructor 설명Description
hresult_error:: from_abi_t 형식hresult_error::from_abi_t type Hresult_error:: from_abi 정적 데이터 멤버의 형식입니다.The type of the hresult_error::from_abi static data member.

정적 데이터 멤버Static data members

함수Function 설명Description
hresult_error:: from_abi 정적 데이터 멤버hresult_error::from_abi static data member Hresult_error (또는 파생 형식)의 생성자에 전달 하 여 생성자가 제한 된 오류 정보를 검색 해야 함을 나타내는 hresult_error:: from_abi_t형식의 인스턴스입니다.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.

멤버 함수Member functions

함수Function 설명Description
hresult_error:: code 함수hresult_error::code function Hresult_error 개체로 표시 되는 오류에 대 한 코드를 검색 합니다.Retrieves the code for the error represented by the hresult_error object.
hresult_error:: message 함수hresult_error::message function Hresult_error 개체로 표시 되는 오류에 대 한 메시지를 검색 합니다.Retrieves the message for the error represented by the hresult_error object.
hresult_error:: to_abi 함수hresult_error::to_abi function 현재 스레드에 대 한 제한 된 오류 정보 개체를 설정 하 고 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.
hresult_error:: try_as 함수hresult_error::try_as function 지원 되는 경우 요청 된 인터페이스를 반환 합니다.Returns the requested interface, if it is supported. nullptr또는 false을 반환 합니다 (없는 경우).Returns nullptr, or false, if it is not.

멤버 연산자Member operators

연산자Operator 설명Description
hresult_error:: operator = (대입 연산자)hresult_error::operator= (assignment operator) Hresult_error 개체에 값을 할당 합니다.Assigns a value to the hresult_error object.

hresult_error:: hresult_error 생성자hresult_error::hresult_error constructor

입력 데이터의 복사본을 사용 하 여 hresult_error 구조체의 새 인스턴스를 초기화 합니다.Initializes a new instance of the hresult_error struct with a copy of the input data.

구문Syntax

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;

매개 변수Parameters

hresult_error 개체를 초기화 하는 다른 hresult_errorother 합니다.other Another hresult_error that initializes the hresult_error object.

hresult_error 개체를 초기화 하는 HRESULT 코드를 code 합니다.code An HRESULT code that initializes the hresult_error object.

개발자가 보고 된 오류 조건을 수정 하는 데 도움이 되는 정보 문자열을 message 합니다.message An informative string to help developers to correct the reported error condition.

오류에 대 한 추가 정보를 저장 하는 오류 개체를 object 합니다.object An error object that stores extra information about the error. Error 개체는 프로세스 간에 아파트 agile, in-process 및 값으로의 마샬링 이어야 합니다.The error object should be apartment-agile, in-proc, and marshal-by-value across processes. 필요한 경우 ILanguageExceptionStackBackTraceILanguageExceptionTransform 를 구현 해야 합니다.It should implement ILanguageExceptionStackBackTrace and ILanguageExceptionTransform if necessary. RoOriginateLanguageException를 참조 하세요.See RoOriginateLanguageException.

hresult_error:: code 함수hresult_error::code function

Hresult_error 개체로 표시 되는 오류에 대 한 코드를 검색 합니다.Retrieves the code for the error represented by the hresult_error object.

구문Syntax

HRESULT code() const noexcept;

반환 값Return value

HRESULT 오류 코드입니다.An HRESULT error code.

hresult_error:: from_abi 정적 데이터 멤버hresult_error::from_abi static data member

Hresult_error (또는 파생 형식)의 생성자에 전달 하 여 생성자가 제한 된 오류 정보를 검색 해야 함을 나타내는 hresult_error:: from_abi_t형식의 인스턴스입니다.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.

구문Syntax

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

hresult_error:: from_abi_t 형식hresult_error::from_abi_t type

Hresult_error:: from_abi 정적 데이터 멤버의 형식입니다.The type of the hresult_error::from_abi static data member.

구문Syntax

struct from_abi_t {};

hresult_error:: message 함수hresult_error::message function

Hresult_error 개체로 표시 되는 오류에 대 한 메시지를 검색 합니다.Retrieves the message for the error represented by the hresult_error object.

구문Syntax

winrt::hstring message() const noexcept;

반환 값Return value

오류 메시지를 포함 하는 winrt:: hstring 입니다.A winrt::hstring containing the error messsage.

hresult_error:: operator = (대입 연산자)hresult_error::operator= (assignment operator)

Hresult_error 개체에 값을 할당 합니다.Assigns a value to the hresult_error object.

구문Syntax

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

매개 변수Parameters

hresult_error 개체에 할당할 hresult_error 값을 other 합니다.other An hresult_error value to assign to the hresult_error object.

반환 값Return value

Hresult_error 개체에 대 한 참조입니다.A reference to the hresult_error object.

hresult_error:: to_abi 함수hresult_error::to_abi function

현재 스레드에 대 한 제한 된 오류 정보 개체를 설정 하 고 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.

구문Syntax

HRESULT to_abi() const noexcept;

반환 값Return value

HRESULT 오류 코드입니다.An HRESULT error code.

hresult_error:: try_as 함수hresult_error::try_as function

지원 되는 경우 요청 된 인터페이스를 반환 합니다.Returns the requested interface, if it is supported. 이이 아니면 nullptr을 반환 합니다.Returns nullptr if it is not. 이 함수는 호출자에 게 다시 전달 하지 않아도 되는 인터페이스를 쿼리해야 할 경우에 유용 합니다.This function is useful if you want to query for an interface that you don't need to pass back to your caller. 예를 들어 IRestrictedErrorInfo 를 검색 하 여 hresult_error 개체가 나타내는 오류에 대 한 제한 된 오류 정보에 액세스할 수 있습니다.For example, you can retrieve an IRestrictedErrorInfo to access the restricted error info for the error represented by the hresult_error object.

구문Syntax

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

템플릿 매개 변수Template parameters

요청 된 인터페이스의 형식을 typename To 합니다.typename To The type of the requested interface.

매개 변수Parameters

요청 된 인터페이스를 받을 값에 대 한 참조를 to 합니다.to A reference to a value to receive the requested interface.

반환 값Return value

요청 된 인터페이스가 지원 되는 경우 요청 된 인터페이스를 참조 하는 winrt:: com_ptr 이 고, 요청 된 인터페이스가 nullptrC++지원 되는 경우 요청 된 인터페이스에 대 한 강력한 형식의 스마트 포인터 (/winrt 또는 타사에 의해 선언 됨)입니다.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.

참고 항목See also