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 函式來關閉句柄。