GetUmsCompletionListEvent 函数 (winbase.h)
检索与指定的用户模式计划关联的事件的句柄 (UMS) 完成列表。
警告
自Windows 11起,不支持用户模式计划。 所有调用都失败,出现错误 ERROR_NOT_SUPPORTED
。
语法
BOOL GetUmsCompletionListEvent(
[in] PUMS_COMPLETION_LIST UmsCompletionList,
[in, out] PHANDLE UmsCompletionEvent
);
参数
[in] UmsCompletionList
指向 UMS 完成列表的指针。 CreateUmsCompletionList 函数提供此指针。
[in, out] UmsCompletionEvent
指向 HANDLE 变量的指针。 输出时, UmsCompletionEvent 参数设置为与指定完成列表关联的事件的句柄。
返回值
如果函数成功,则返回非零值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
注解
当系统将项目排队到空完成列表时,系统会发出 UMS 完成列表事件的信号。 完成列表事件句柄可以与采用事件句柄的任何 等待函数 一起使用。 发出事件信号时,应用程序通常会调用 DequeueUmsCompletionListItems 来检索完成列表的内容。
事件句柄在删除其完成列表之前保持有效。 请勿使用事件句柄等待已删除或正在删除的完成列表。
如果不再需要句柄,请使用 CloseHandle 函数关闭句柄。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 仅 Windows 7 (64 位) [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | winbase.h (包括 Windows.h) |
Library | Kernel32.lib |
DLL | Kernel32.dll |
API 集 | windows 7) 中引入的 api-ms-win-core-ums-l1-1-0 ( |