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 매개 변수는 지정된 완료 목록과 연결된 이벤트에 대한 핸들로 설정됩니다.

반환 값

함수가 성공하면 0이 아닌 값을 반환합니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 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

대기 함수