NAME¶

RtlRegisterWait (NTDLL.@)

SYNOPSIS¶

NTSTATUS RtlRegisterWait
(
PHANDLE NewWaitObject,
HANDLE Object,
RTL_WAITORTIMERCALLBACKFUNC Callback,
PVOID Context,
ULONG Milliseconds,
ULONG Flags
)

DESCRIPTION¶

Registers a wait for a handle to become signaled.

PARAMS¶

NewWaitObject [In] Handle to the new wait object. Use RtlDeregisterWait(3w) to free it. Object [In] Object to wait to become signaled. Callback [In] Callback function to execute when the wait times out or the handle is signaled. Context [In] Context to pass to the callback function when it is executed. Milliseconds [In] Number of milliseconds to wait before timing out. Flags [In] Flags. See notes.

RETURNS¶

Success: STATUS_SUCCESS. Failure: Any NTSTATUS code.

NOTES¶

Flags can be one or more of the following: WT_EXECUTEDEFAULT - Executes the work item in a non-I/O worker thread. WT_EXECUTEINIOTHREAD - Executes the work item in an I/O worker thread. WT_EXECUTEINPERSISTENTTHREAD - Executes the work item in a thread that is persistent. WT_EXECUTELONGFUNCTION - Hints that the execution can take a long time. WT_TRANSFER_IMPERSONATION - Executes the function with the current access token.

IMPLEMENTATION¶

Declared in "winternl.h". Implemented in "dlls/ntdll/threadpool.c". Debug channel "threadpool".