Поделиться через


Функция 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
Header winbase.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll
Набор API api-ms-win-core-ums-l1-1-0 (представлено в Windows 7)

См. также раздел

CreateUmsCompletionList

DequeueUmsCompletionListItems

Функции ожидания