CHandle Class

Article
2013-01-08

This class provides methods for creating and using a handle object.

class CHandle

Members

Public Constructors

Name	Description
CHandle::CHandle	The constructor.
CHandle::~CHandle	The destructor.

Public Methods

Name	Description
CHandle::Attach	Call this method to attach the CHandle object to an existing handle.
CHandle::Close	Call this method to close a CHandle object.
CHandle::Detach	Call this method to detach a handle from a CHandle object.

Public Operators

Name	Description
CHandle::operator HANDLE	Returns the value of the stored handle.
CHandle::operator =	Assignment operator.

Public Data Members

Name	Description
CHandle::m_h	The member variable that stores the handle.

Remarks

A CHandle object can be used whenever a handle is required: the main difference is that the CHandle object will automatically be deleted.

Note

Some API functions will use NULL as an empty or invalid handle, while others use INVALID_HANDLE_VALUE. CHandle only uses NULL and will treat INVALID_HANDLE_VALUE as a real handle. If you call an API which can return INVALID_HANDLE_VALUE, you should check for this value before calling CHandle::Attach or passing it to the CHandle constructor, and instead pass NULL.

Requirements

Header: atlbase.h

Share via