InterlockedPushEntrySList function
Inserts an item at the front of a singly linked list. Access to the list is synchronized on a multiprocessor system.
Syntax
PSLIST_ENTRY WINAPI InterlockedPushEntrySList( _Inout_ PSLIST_HEADER ListHead, _Inout_ PSLIST_ENTRY ListEntry );
Parameters
- ListHead [in, out]
-
Pointer to an SLIST_HEADER structure that represents the head of a singly linked list.
- ListEntry [in, out]
-
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
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
|
Minimum supported client |
Windows XP [desktop apps | Windows Store apps] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps | Windows Store apps] |
|
Minimum supported phone |
Windows Phone 8 |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
- Interlocked Singly Linked Lists
- InterlockedPopEntrySList
- InterlockedPushListSList
- InterlockedPushListSListEx
- InterlockedFlushSList
- SLIST_ENTRY
- Using Singly Linked Lists