InterlockedPopEntrySList function (interlockedapi.h)

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

Syntax

PSLIST_ENTRY InterlockedPopEntrySList(
  [in, out] PSLIST_HEADER ListHead
);

Parameters

[in, out] ListHead

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

InterlockedFlushSList

InterlockedPushEntrySList

InterlockedPushListSList

InterlockedPushListSListEx

SLIST_ENTRY

Using Singly Linked Lists

Vertdll APIs available in VBS enclaves