GetNextUmsListItem function (winbase.h)

Returns the next user-mode scheduling (UMS) thread context in a list of thread contexts.


As of Windows 11, user-mode scheduling is not supported. All calls fail with the error ERROR_NOT_SUPPORTED.


PUMS_CONTEXT GetNextUmsListItem(
  [in, out] PUMS_CONTEXT UmsContext


[in, out] UmsContext

A pointer to a UMS context in a list of thread contexts. This list is retrieved by the DequeueUmsCompletionListItems function.

Return value

If the function succeeds, it returns a pointer to the next thread context in the list.

If there is no thread context after the context specified by the UmsContext parameter, the function returns NULL. To get extended error information, call GetLastError.


Requirement Value
Minimum supported client Windows 7 (64-bit only) [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header winbase.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll
API set api-ms-win-core-ums-l1-1-0 (introduced in Windows 7)

See also