共用方式為


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)
程式庫 Kernel32.lib
DLL Kernel32.dll
API 集合 api-ms-win-core-ums-l1-1-0 (在 Windows 7)

另請參閱

CreateUmsCompletionList

DequeueUmsCompletionListItems

Wait 函式