目录
函数清单
1.CreateFileMapping 方法
HANDLE CreateFileMapping( [in] HANDLE hFile, [in, optional] LPSECURITY_ATTRIBUTES lpFileMappingAttributes, [in] DWORD flProtect, [in] DWORD dwMaximumSizeHigh, [in] DWORD dwMaximumSizeLow, [in, optional] LPCWSTR lpName );
功能
- 创建或打开命名或未命名的共享内存对象。
参数
- hFile:创建共享内存则设置为 INVALID_HANDLE_VALUE,并且还必须为 dwMaximumSizeHigh 和 dwMaximumSizeLow 参数中的文件映射对象指定大小
- lpFileMappingAttributes:共享内存对象的安全属性,通常设置为 NULL,则子进程无法继承句柄,并且共享内存对象获取默认的安全描述符。
- flProtect:指定共享内存对象的访问方式。通常设置为 PAGE_EXECUTE_READWRITE,表示可进行只读、写入复制、读/写或执行访问。
- dwMaximumSizeHigh:高位字节大小,通常设置为0。
- dwMaximumSizeLow:地位字节大小,设置共享内存段的大小。
- lpName:共享内存对象的标识名称。
返回值
- 如果函数成功,则返回值是新创建的共享内存对象的句柄。
- 如果该对象在函数调用之前存在,则函数将返回现有对象的句柄 (其当前大小,而不是指定的大小) , GetLastError 返回 ERROR_ALREADY_EXISTS。
- 如果函数失败,则返回值为 NULL。 要获得更多的错误信息,请调用 GetLastError。
2.OpenFileMapping 方法
HANDLE OpenFileMapping( [in] DWORD dwDesiredAccess, [in] BOOL bInheritHandle, [in] LPCWSTR lpName );
功能
- 打开命名共享内存对象。
参数
- dwDesiredAccess:对共享内存对象的访问方式。用于共享内存段的保护,通常设置为 FILE_MAP_ALL_ACCESS,可执行所有访问权限。
- bInheritHandle:如果此参数为 TRUE, 则 CreateProcess 函数创建的进程可以继承句柄;否则,无法继承句柄。
- lpName:要打开的共享内存对象的标识名称。
返回值
- 如果函数成功,则返回值是指定共享内存对象的打开句柄。
- 如果函数失败,则返回值为 NULL。 要获得更多的错误信息,请调用 GetLastError。
3.MapViewOfFile 方法
LPVOID MapViewOfFile( [in] HANDLE hFileMappingObject, [in] DWORD dwDesiredAccess, [in] DWORD dwFileOffsetHigh, [in] DWORD dwFileOffsetLow, [in] SIZE_T dwNumberOfBytesToMap );
功能
- 将共享内存映射到调用进程的地址空间。
参数
- hFileMappingObject:共享内存对象的句柄。 CreateFileMapping 和 OpenFileMapping 函数返回此句柄。
- dwDesiredAccess:对共享内存对象的访问方式,通常指定为FILE_MAP_ALL_ACCESS,表示可读可写。
- dwFileOffsetHigh:高位字节大小,通常设置为0。
- dwFileOffsetLow:地位字节大小,通常设置为0。
- dwNumberOfBytesToMap:要映射到共享内存段的字节数。
返回值
- 如果函数成功,则返回值为共享内存段的起始地址。
- 如果函数失败,则返回值为 NULL。 要获得更多的错误信息,请调用 GetLastError。
4.UnmapViewOfFile 方法
BOOL UnmapViewOfFile( [in] LPCVOID lpBaseAddress );
功能
- 从调用进程的地址空间取消映射共享内存段。
参数
- lpBaseAddress:指向要取消映射的共享内存指针。此值必须与上一次调用MapViewOfFile 函数返回的值相同。
返回值
- 如果该函数成功,则返回值为非零值。
- 如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
5.CreateSemaphore 方法
HANDLE CreateSemaphore( [in, optional] LPSECURITY_ATTRIBUTES lpSemaphoreAttributes, [in] LONG lInitialCount, [in] LONG lMaximumCount, [in, optional] LPCWSTR lpName );
功能
- 创建或打开命名或未命名的信号量对象。
参数
- lpSemaphoreAttributes:信号量安全特征。通常指定为 NULL,但子进程无法继承句柄。
- lInitialCount:信号量对象的初始可使用资源数目。 此值必须>=0,并且<=lMaximumCount。如果设置为0,信号量为未触发状态。
- lMaximumCount:信号量对象的最大资源计数。 此值必须大于零。
- lpName:信号量对象的名称。各进程实现同步会用到该名称。
返回值
- 如果函数成功,则返回值是信号量对象的句柄。
- 如果在函数调用之前存在相同命名的信号量对象,则函数将返回现有对象的句柄,GetLastError 返回 ERROR_ALREADY_EXISTS。
- 如果函数失败,则返回值为 NULL。 要获得更多的错误信息,请调用 GetLastError。
6. OpenSemaphore 方法
HANDLE OpenSemaphore( [in] DWORD dwDesiredAccess, [in] BOOL bInheritHandle, [in] LPCWSTR lpName );
功能
- 打开现有的命名信号量对象。
参数
- dwDesiredAccess:对信号量对象的访问权限,通常指定为 SEMAPHORE_ALL_ACCESS。
- bInheritHandle:如果此值为 TRUE,则此过程创建的进程将继承句柄。 否则,进程不会继承此句柄。
- lpName:打开已有的信号量名称。
返回值
- 如果函数成功,则返回值是信号灯对象的句柄。
- 如果函数失败,则返回值为 NULL。 要获得更多的错误信息,请调用 GetLastError。
7.WaitForSingleObject 方法
DWORD WaitForSingleObject( [in] HANDLE hHandle, [in] DWORD dwMilliseconds );
功能
- 阻塞等待指定对象处于信号状态或超时间隔已过。
参数
- hHandle:创建的信号量对象的句柄。
- dwMilliseconds:超时间隔(以毫秒为单位)。通常指定为 INFINITE,表示仅当发出对象信号时,该函数才会返回。
返回值
- 如果函数成功,则返回值指示导致函数返回的事件。可以是下列值之一
返回代码/值 描述 WAIT_ABANDONED
指定的对象是一个互斥对象,该对象不是由拥有互斥对象的线程在拥有线程终止之前释放的。 互斥对象所有权授予调用线程,互斥状态设置为非对齐状态。如果互斥体保护持久状态信息,则应检查该信息是否一致性。 WAIT_OBJECT_0
指定对象的状态已发出信号。 WAIT_TIMEOUT
超时间隔已过,对象的状态未对齐。 WAIT_FAILED
函数失败。 要获得更多的错误信息,请调用 GetLastError。
8.ReleaseSemaphore 方法
BOOL ReleaseSemaphore( [in] HANDLE hSemaphore, [in] LONG lReleaseCount, [out, optional] LPLONG lpPreviousCount );
功能
- 按指定量增加指定的信号量对象的资源计数。
参数
- hSemaphore:设置为 CreateSemaphore 或 OpenSemaphore 函数返回的信号量对象句柄。
- lReleaseCount:信号量对象的当前资源计数将增加的量。该值必须>0且<=最大资源数量,通常设置为1。
- lpPreviousCount:指向一个变量的指针,用于接收信号量的先前资源计数。如果不需要先前资源计数,此参数可以为 NULL 。
返回值
- 如果该函数成功,则返回值为非零值。
- 如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
9.CloseHandle 方法
BOOL CloseHandle( [in] HANDLE hObject );
功能
- 关闭打开的对象句柄。
参数
- hObject:打开对象的有效句柄。
返回值
- 如果该函数成功,则返回值为非零值。
- 如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
10.GetLastError 方法
_Post_equals_last_error_ DWORD GetLastError();
功能
- 检索调用线程的最后错误代码值。 最后一个错误代码是按线程维护的。 多个线程不会覆盖彼此的最后错误代码。
返回值
- 返回值是调用线程的最后错误代码。