0 out of 1 rated this helpful - Rate this topic

InterlockedPushEntrySList function

Applies to: desktop apps | Metro style apps

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

Minimum supported server

Windows Server 2003

Header

WinBase.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

Interlocked Singly Linked Lists
InterlockedPopEntrySList
SLIST_ENTRY

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ