CHandle Class
TOC
Collapse the table of content
Expand the table of content

CHandle Class

 

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


class CHandle

Name

Description

CHandle::CHandle

The constructor.

CHandle::~CHandle

The destructor.

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.

Name

Description

CHandle::operator HANDLE

Returns the value of the stored handle.

CHandle::operator =

Assignment operator.

Name

Description

CHandle::m_h

The member variable that stores the handle.

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

System_CAPS_noteNote

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

Show:
© 2016 Microsoft