关闭内核对象 - CloseHandle

函数简介

关闭一个内核对象句柄。内核对象包括文件、线程、进程、互斥量、事件等系统资源。此函数用于释放系统资源，防止句柄泄漏。

接口名称

CloseHandle

DLL调用

int CloseHandle(long instance, long handle)

参数说明

参数名类型说明
instance长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
handle长整数型要关闭的对象句柄

示例

// 关闭文件句柄
long file_handle = CreateFile(ola, "test.txt", GENERIC_READ, 0, OPEN_EXISTING, 0, 0);
if (file_handle != 0) {
    // 使用文件句柄进行操作
    // ...
    
    // 关闭文件句柄
    int result = CloseHandle(ola, file_handle);
    if (result == 1) {
        printf("文件句柄关闭成功\n");
    } else {
        printf("文件句柄关闭失败\n");
    }
}

// 关闭线程句柄
long thread_handle = CreateRemoteThread(ola, target_hwnd, start_address, parameter, 0, &thread_id);
if (thread_handle != 0) {
    // 等待线程完成
    // ...
    
    // 关闭线程句柄
    int result = CloseHandle(ola, thread_handle);
    if (result == 1) {
        printf("线程句柄关闭成功\n");
    }
}

// 关闭进程句柄
long process_handle = OpenProcess(ola, PROCESS_ALL_ACCESS, FALSE, process_id);
if (process_handle != 0) {
    // 对进程进行操作
    // ...
    
    // 关闭进程句柄
    int result = CloseHandle(ola, process_handle);
    if (result == 1) {
        printf("进程句柄关闭成功\n");
    }
}

// 关闭互斥量句柄
long mutex_handle = CreateMutex(ola, NULL, FALSE, "MyMutex");
if (mutex_handle != 0) {
    // 使用互斥量
    // ...
    
    // 关闭互斥量句柄
    int result = CloseHandle(ola, mutex_handle);
    if (result == 1) {
        printf("互斥量句柄关闭成功\n");
    }
}

// 批量关闭句柄
long handles[] = {handle1, handle2, handle3, handle4};
int handle_count = sizeof(handles) / sizeof(handles[0]);

for (int i = 0; i < handle_count; i++) {
    if (handles[i] != 0) {
        int result = CloseHandle(ola, handles[i]);
        if (result == 1) {
            printf("句柄 %d 关闭成功\n", i);
        } else {
            printf("句柄 %d 关闭失败\n", i);
        }
    }
}

返回值

整数型:

  • 1: 关闭成功
  • 0: 关闭失败

注意事项

  • 关闭句柄后，该句柄将不再有效，不能再次使用
  • 关闭无效句柄不会导致错误，但会返回失败
  • 建议在不再需要句柄时立即关闭，避免句柄泄漏
  • 某些系统对象（如进程、线程）在关闭句柄后仍可能继续运行
  • 关闭句柄不会影响其他引用同一对象的句柄
  • 在程序退出前应确保所有句柄都已正确关闭
Last Updated: