InterlockedPopEntrySList function

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

Syntax

PSLIST_ENTRY WINAPI InterlockedPopEntrySList(
  _Inout_ PSLIST_HEADER ListHead
);

Parameters

ListHead [in, out]

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

Return value

The return value is a pointer to the item removed from the list. If the list is empty, the return value is NULL.

Remarks

All list items must be aligned on a MEMORY_ALLOCATION_ALIGNMENT boundary; otherwise, this function will behave unpredictably. See _aligned_malloc.

Examples

For an example, see Using Singly Linked Lists.

Requirements

See also

Interlocked Singly Linked Lists

InterlockedPushEntrySList

InterlockedPushListSList

InterlockedPushListSListEx

InterlockedFlushSList

SLIST_ENTRY

Using Singly Linked Lists