RtlQueueWorkItem.3w

Langue: en

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

Section: 3 (Bibliothèques de fonctions)

NAME

RtlQueueWorkItem (NTDLL.@)

SYNOPSIS

NTSTATUS RtlQueueWorkItem
 (
  PRTL_WORK_ITEM_ROUTINE Function,
  PVOID                  Context,
  ULONG                  Flags
 )

DESCRIPTION

Queues a work item into a thread in the thread pool.

PARAMS

Function [In] Work function to execute.

Context [In] Context to pass to the work function when it is executed.

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".