c#句柄相关api

在C#中，句柄（Handle）是Windows操作系统用于标识和管理资源的一种机制，以下是一些常用的与句柄相关的API：

1、CreateFile

功能：创建、打开或截取文件、管道、邮件槽等内核对象，并返回一个可以访问该对象的句柄。

语法：HANDLE CreateFile(LPCTSTR lpFileName, DWORD dwDesiredAccess, DWORD dwShareMode, LPSECURITY_ATTRIBUTES lpSecurityAttributes, DWORD dwCreationDisposition, DWORD dwFlagsAndAttributes, HANDLE hTemplateFile);

参数说明：

lpFileName：指向文件名的指针。

dwDesiredAccess：指定对文件的访问权限，如读取、写入等。

dwShareMode：指定文件的共享模式，如只读、读写等。

lpSecurityAttributes：指向安全属性的指针，通常为NULL。

dwCreationDisposition：指定文件存在时的操作方式，如新建、打开现有文件等。

dwFlagsAndAttributes：文件的属性和标志，如隐藏、只读等。

hTemplateFile：指向模板文件的句柄，通常为NULL。

返回值：如果函数成功，则返回一个有效的句柄；如果失败，则返回INVALID_HANDLE_VALUE。

2、ReadFile

功能：从文件、管道、套接字等对象中读取数据。

语法：BOOL ReadFile(HANDLE hFile, LPVOID lpBuffer, DWORD nNumberOfBytesToRead, LPDWORD lpNumberOfBytesRead, LPOVERLAPPED lpOverlapped);

参数说明：

hFile：要读取的文件的句柄。

lpBuffer：指向接收数据的缓冲区的指针。

nNumberOfBytesToRead：要读取的字节数。

lpNumberOfBytesRead：指向实际读取的字节数的指针。

lpOverlapped：指向OVERLAPPED结构的指针，用于异步操作。

返回值：如果函数成功，则返回TRUE；如果失败，则返回FALSE。

3、WriteFile

功能：向文件、管道、套接字等对象中写入数据。

语法：BOOL WriteFile(HANDLE hFile, LPCVOID lpBuffer, DWORD nNumberOfBytesToWrite, LPDWORD lpNumberOfBytesWritten, LPOVERLAPPED lpOverlapped);

参数说明：

hFile：要写入的文件的句柄。

lpBuffer：指向要写入的数据的缓冲区的指针。

nNumberOfBytesToWrite：要写入的字节数。

lpNumberOfBytesWritten：指向实际写入的字节数的指针。

lpOverlapped：指向OVERLAPPED结构的指针，用于异步操作。

返回值：如果函数成功，则返回TRUE；如果失败，则返回FALSE。

4、CloseHandle

功能：关闭由CreateFile、CreatePipe、CreateMailslot等函数创建的内核对象句柄。

语法：BOOL CloseHandle(HANDLE hObject);

参数说明：hObject：要关闭的对象的句柄。

返回值：如果函数成功，则返回TRUE；如果失败，则返回FALSE。

5、FindFirstFile

功能：查找与指定路径和文件名匹配的第一个文件，并返回一个包含文件信息的WIN32_FIND_DATA结构。

语法：HANDLE FindFirstFile(LPCSTR lpFileName, LPWIN32_FIND_DATA lpFindFileData);

参数说明：

lpFileName：指向要查找的文件名的指针。

lpFindFileData：指向WIN32_FIND_DATA结构的指针，用于存储文件信息。

返回值：如果函数成功，则返回一个有效的句柄；如果失败，则返回INVALID_HANDLE_VALUE。

6、FindNextFile

功能：继续查找与指定路径和文件名匹配的下一个文件，并更新WIN32_FIND_DATA结构。

语法：BOOL FindNextFile(HANDLE hFindFile, LPWIN32_FIND_DATA lpFindFileData);

参数说明：

hFindFile：由FindFirstFile函数返回的句柄。

lpFindFileData：指向WIN32_FIND_DATA结构的指针，用于存储文件信息。

返回值：如果函数成功，则返回TRUE；如果失败，则返回FALSE。

7、GetFileInformationByHandle

功能：获取与指定文件句柄关联的文件的信息。

语法：BOOL GetFileInformationByHandle(HANDLE hFile, LPBY_HANDLE_FILE_INFORMATION lpFileInformation);

参数说明：

hFile：要查询的文件的句柄。

lpFileInformation：指向BY_HANDLE_FILE_INFORMATION结构的指针，用于存储文件信息。

返回值：如果函数成功，则返回TRUE；如果失败，则返回FALSE。

8、SetFilePointer

功能：移动文件指针的位置。

语法：DWORD SetFilePointer(HANDLE hFile, LONG lDistanceToMove, PLONG lpDistanceToMoveHigh, DWORD dwMoveMethod);

参数说明：

hFile：要移动指针的文件的句柄。

lDistanceToMove：要移动的距离，以字节为单位。

lpDistanceToMoveHigh：指向距离的高32位的指针，通常为NULL。

dwMoveMethod：移动方法，如文件开始、当前位置、文件结束等。

返回值：如果函数成功，则返回新的文件指针位置；如果失败，则返回INVALID_SET_FILE_POINTER。

9、DuplicateHandle

功能：复制一个句柄，使其可以在另一个进程或线程中使用。

语法：BOOL DuplicateHandle(HANDLE hSourceProcessHandle, HANDLE hSourceHandle, HANDLE hTargetProcessHandle, LPHANDLE lpTargetHandle, DWORD dwDesiredAccess, BOOL bInheritHandle, DWORD dwOptions);

参数说明：

hSourceProcessHandle：源进程的句柄。

hSourceHandle：要复制的句柄。

hTargetProcessHandle：目标进程的句柄。

lpTargetHandle：指向复制后的句柄的指针。

dwDesiredAccess：对复制后的句柄的访问权限。

bInheritHandle：指定复制后的句柄是否可以被继承。

dwOptions：复制选项，通常为0。

返回值：如果函数成功，则返回TRUE；如果失败，则返回FALSE。

这些API提供了对Windows资源的底层访问和控制能力，但同时也需要谨慎使用，以避免资源泄漏和其他潜在问题，在使用这些API时，务必遵循正确的用法和最佳实践，以确保程序的稳定性和安全性。