C++：GetClipboardData()获取剪贴板数据函数

1. 函数功能概述

GetClipboardData()函数用于从已经打开的剪贴板中获取数据。它根据指定的数据格式，返回一个指向剪贴板数据的句柄。这个句柄可以进一步被处理，以获取实际的数据内容。

2. 函数原型和参数

函数原型是HANDLE GetClipboardData(UINT uFormat);。

参数uFormat指定了要获取的剪贴板数据的格式。常见的数据格式有CF_TEXT（以空字符结尾的ANSI文本）、CF_UNICODETEXT（以空字符结尾的Unicode文本）、CF_BITMAP（位图）、CF_METAFILEPICT（图元文件）等。通过指定不同的数据格式，可以获取不同类型的剪贴板数据。

3. 函数返回值

如果函数调用成功，它将返回一个指向剪贴板数据的句柄。这个句柄可以用于后续的数据访问操作，如读取文本内容或者处理位图等。

如果指定的数据格式不存在于剪贴板中，或者发生其他错误，函数将返回NULL。

4. 使用示例

以下是一个获取剪贴板中Unicode文本数据的示例（假设已经包含了<windows.h>头文件）：

#include <iostream>
#include <windows.h>
int main()
{
    if (OpenClipboard(NULL))
    {
        HANDLE hData = GetClipboardData(CF_UNICODETEXT);
        if (hData!= NULL)
        {
            wchar_t* pwszText = static_cast<wchar_t*>(GlobalLock(hData));
            if (pwszText!= NULL)
            {
                std::wcout << pwszText << std::endl;
                GlobalUnlock(hData);
            }
        }
        CloseClipboard();
    }
    else
    {
        std::cerr << "无法打开剪贴板" << std::endl;
    }
    return 0;
}

在这个示例中，首先调用OpenClipboard(NULL)打开剪贴板。然后使用GetClipboardData(CF_UNICODETEXT)尝试获取剪贴板中的Unicode文本数据。如果获取到的数据句柄不为NULL，就通过GlobalLock(hData)锁定数据内存块，并将其转换为wchar_t*类型的指针pwszText，接着使用std::wcout输出文本内容。最后，使用GlobalUnlock(hData)解锁内存块，并调用CloseClipboard()关闭剪贴板。