RtlInterlockedPushEntrySList function (winnt.h)

Inserts an item at the front of a singly linked list. Access to the list is synchronized on a multiprocessor system.

Syntax

NTSYSAPI PSLIST_ENTRY RtlInterlockedPushEntrySList(
  [in] PSLIST_HEADER                 ListHead,
  [in] __drv_aliasesMem PSLIST_ENTRY ListEntry
);

Parameters

[in] ListHead

A pointer to an SLIST_HEADER structure that represents the head of a singly linked list.

[in] ListEntry

A pointer to an SLIST_ENTRY structure that represents an item in a singly linked list.

Return value

The return value is the previous first item in the list. If the list was previously empty, the return value is NULL.

Remarks

Calls to the InterlockedPushEntrySList function are forwarded to the RtlInterlockedPushEntrySList function. Applications should call InterlockedPushEntrySList instead of calling this function directly.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header winnt.h (include Windows.h)
Library ntdll.lib
DLL ntdll.dll

See also

Interlocked Singly Linked Lists