Export (0) Print
Expand All
Expand Minimize

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.

Windows Phone 8: This API is supported.

Windows Phone 8.1: This API is supported.

Examples

For an example, see Using Singly Linked Lists.

Requirements

Minimum supported client

Windows XP [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2003 [desktop apps | Windows Store apps]

Header

WinBase.h on Windows Vista, Windows 7, Windows Server 2008, and Windows Server 2008 R2 (include Windows.h);
InterlockedAPI.h on Windows 8 and Windows Server 2012 (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

Interlocked Singly Linked Lists
InterlockedPushEntrySList
InterlockedPushListSList
InterlockedPushListSListEx
InterlockedFlushSList
SLIST_ENTRY
Using Singly Linked Lists

 

 

Community Additions

ADD
Show:
© 2014 Microsoft