Expand Minimize

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.

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
InterlockedPopEntrySList
InterlockedPushListSList
InterlockedPushListSListEx
InterlockedFlushSList
SLIST_ENTRY
Using Singly Linked Lists

 

 

Community Additions

ADD
Show:
© 2014 Microsoft