C++：OpenClipboard()打开剪贴板函数

1. 函数功能概述

OpenClipboard()是一个用于操作剪贴板的Windows API函数。它的主要功能是打开剪贴板，使得一个应用程序可以访问剪贴板中的数据。在对剪贴板进行读取或写入操作之前，必须先成功调用OpenClipboard()函数。只有打开剪贴板后，才能进行如获取剪贴板数据格式、读取数据、写入数据等操作。

2. 函数原型和参数

函数原型为BOOL OpenClipboard(HWND hWndNewOwner);。

参数hWndNewOwner是一个窗口句柄（HWND类型），它指定了打开剪贴板的窗口。这个窗口将成为剪贴板的新所有者。如果这个参数为NULL，则表示当前任务是剪贴板的所有者。通常情况下，传递当前窗口的句柄作为参数，这样可以确保正确的权限管理和消息传递与剪贴板操作相关联。

3. 函数返回值

如果函数成功打开剪贴板，返回值为非零值（TRUE）。

如果函数调用失败，返回值为零（FALSE）。常见的失败原因包括另一个窗口已经将剪贴板锁定（尚未关闭），或者系统资源不足等情况。

4. 使用示例

以下是一个简单的示例，展示如何使用OpenClipboard()函数来获取剪贴板中的文本数据（假设已经包含了必要的头文件<windows.h>）：

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

在这个示例中，首先调用OpenClipboard(NULL)尝试打开剪贴板。如果成功打开，就使用GetClipboardData(CF_TEXT)获取剪贴板中的文本数据（CF_TEXT是一个预定义的剪贴板数据格式，表示文本格式）。然后通过GlobalLock函数锁定数据内存块，将其转换为字符指针pszText，并输出文本内容。最后，使用GlobalUnlock解锁数据内存块，并调用CloseClipboard()关闭剪贴板。