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 (