RtlRegisterWait.3w

Langue: en

Version: Jun 2009 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

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

Defined in "winternl.h".

Implemented in "dlls/ntdll/threadpool.c".

Debug channel "threadpool".