Compartir a través de


CAtlException Class

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at CAtlException Class.

This class defines an ATL exception.

Syntax

class CAtlException

Members

Public Constructors

Name Description
CAtlException::CAtlException The constructor.

Public Operators

Name Description
CAtlException::operator HRESULT Casts the current object to an HRESULT value.

Public Data Members

Name Description
CAtlException::m_hr The variable of type HRESULT created by the object and used to store the error condition.

Remarks

A CAtlException object represents an exception condition related to an ATL operation. The CAtlException class includes a public data member that stores the status code indicating the reason for the exception and a cast operator that allows you to treat the exception as if it were an HRESULT.

In general, you will call AtlThrow rather than creating a CAtlException object directly.

Requirements

Header: atlexcept.h

CAtlException::CAtlException

The constructor.

CAtlException(HRESULT hr) throw();
CAtlException() throw();

Parameters

hr
The HRESULT error code.

CAtlException::operator HRESULT

Casts the current object to an HRESULT value.

operator HRESULT() const throw ();

CAtlException::m_hr

The HRESULT data member.

HRESULT m_hr;

Remarks

The data member that stores the error condition. The HRESULT value is set by the constructor, CAtlException::CAtlException.

See Also

AtlThrow
Class Overview