HANDLE的无效值：NULL还是INVALID_HANDLE_VALUE? 以及对HANDLE的RAII封装

打开/创建一个HANDLE而忘记close的情况时有发生。利用RAII的思想，将HANDLE封装为一个类，在其析构函数中进行close，是一个不错

的方法。

ATL提供了一个CHandle类，但是提出了以下使用注意事项：

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.

即：有些API将NULL作为无效的HANLDE，但有些则将INVALID_HANDLE_VALUE作为无效值。CHandle只使用NULL作为无效HANDLE，

而将INVALID_HANLDE_VALUE视为一个真正的HANDLE.

看看相关定义：

HANDLE定义为：typedef void *HANDLE;（在WinNt.h中定义的更详细一些）

NULL定义为：#define NULL 0 (在stddef.h中定义的更详细一些)

INVALID_HANDLE_VALUE定义为：#define INVALID_HANDLE_VALUE ((HANDLE)(LONG_PTR)-1) . 其实就是补码表示的-1解释为

无符号数，就是0xFFFFFFFF.

比如，CreateThread返回的无效HANDLE是NULL，而CreateFile则以INVALID_HANDLE_VALUE表示无效HANDLE.因此使用返回

HANDLE的API需查看MSDN以保证安全.

下面这篇文章分析了HANDLE无效值不统一表示的历史原因以及相关注意：

Why are HANDLE return values so inconsistent?

那么，对HANDLE的封装怎么处理为好？

看看下例（http://stackoverflow.com/questions/13028872/proper-way-close-winapi-handles-avoiding-of-repeated-closing）：

基本类模板：

template< class traits >
class HandleWrapper
{
private:
    traits::HandleType FHandle;
public:
    HandleWrapper()：
        FHandle(traits::InvalidValue)
    {
    }
    HandleWrapper(const traits::HandleType value)：
        FHandle(value)
    {
    }
    ~HandleWrapper()
    {
        Close();
    }
    void Close()
    {
        if (FHandle != traits::InvalidValue)
        {
            traits::Close(FHandle);
            FHandle = traits::InvalidValue;
        }
    }
    bool operator !() const {
        return (FHandle == traits:::InvalidValue);
    }
    operator bool() const {
        return (FHandle != traits:::InvalidValue);
    }
    operator traits::HandleType() {
        return FHandle;
    }
};

针对不同的Windows对象，提供不同的特化traits:

struct KernelHandleTraits
{
    typedef HANDLE HandleType;
    static const HANDLE InvalidValue = INVALID_HANDLE_VALUE;
    static void Close(HANDLE value)
    {
        CloseHandle(value);
    }
};
HandleWrapper<KernelHandleTraits> hFile(CreateFile(...));

struct NullKernelHandleTraits
{
    typedef HANDLE HandleType;
    static const HANDLE InvalidValue = NULL;
    static void Close(HANDLE value)
    {
        CloseHandle(value);
    }
};
HandleWrapper<NullKernelHandleTraits> hMapping(CreateFileMapping(...));

struct FileMapViewTraits
{    
    typedef void* HandleType;
    static const void* InvalidValue = NULL;
    static void Close(void *value)
    {
        UnmapViewOfFile(value);
    }
};
HandleWrapper<FileMapViewTraits> hView(MapViewOfFile(...));

struct GDIBitmapHandleTraits
{    
    typedef HBITMAP HandleType;
    static const HBITMAP InvalidValue = NULL;
    static void Close(HBITMAP value)
    {
        DeleteObject(value);
    }
};
HandleWrapper<GDIBitmapTraits> hBmp(CreateBitmap(...));

妙哉！