---
title: "CAtlException Class"
ms.date: "11/04/2016"
f1_keywords: ["CAtlException", "ATLEXCEPT/ATL::CAtlException", "ATLEXCEPT/ATL::CAtlException::CAtlException", "ATLEXCEPT/ATL::CAtlException::m_hr"]
helpviewer_keywords: ["CAtlException class"]
ms.assetid: 3fd7b041-f70d-4292-b947-0d70781d95a8
---
# CAtlException Class

This class defines an ATL exception.

## Syntax

```cpp
class CAtlException
```

## Members

### Public Constructors

|Name|Description|
|----------|-----------------|
|[CAtlException::CAtlException](#catlexception)|The constructor.|

### Public Operators

|Name|Description|
|----------|-----------------|
|[CAtlException::operator HRESULT](#operator_hresult)|Casts the current object to an HRESULT value.|

### Public Data Members

|Name|Description|
|----------|-----------------|
|[CAtlException::m_hr](#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

## <a name="catlexception"></a> CAtlException::CAtlException

The constructor.

```cpp
CAtlException(HRESULT hr) throw();
CAtlException() throw();
```

### Parameters

*hr*<br/>
The HRESULT error code.

## <a name="operator_hresult"></a> CAtlException::operator HRESULT

Casts the current object to an HRESULT value.

```cpp
operator HRESULT() const throw ();
```

## <a name="m_hr"></a> CAtlException::m_hr

The HRESULT data member.

```cpp
HRESULT m_hr;
```

### Remarks

The data member that stores the error condition. The HRESULT value is set by the constructor, [CAtlException::CAtlException](#catlexception).

## See also

[AtlThrow](debugging-and-error-reporting-global-functions.md#atlthrow)<br/>
[Class Overview](../../atl/atl-class-overview.md)