Export (0) Print
Expand All
Expand Minimize

InitializeSListHead function

Initializes the head of a singly linked list.

Syntax


void WINAPI InitializeSListHead(
  _Inout_  PSLIST_HEADER ListHead
);

Parameters

ListHead [in, out]

A pointer to an SLIST_HEADER structure that represents the head of a singly linked list. This structure is for system use only.

Return value

This function does not return a value.

Remarks

All list items must be aligned on a MEMORY_ALLOCATION_ALIGNMENT boundary. Unaligned items can cause unpredictable results. See _aligned_malloc.

To add items to the list, use the InterlockedPushEntrySList function. To remove items from the list, use the InterlockedPopEntrySList function.

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 XP, Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008, and Windows Server 2008 R2 (include Windows.h);
Interlockedapi.h on Windows 8 and Windows Server 2012

Library

Kernel32.lib

DLL

Kernel32.dll

See also

Interlocked Singly Linked Lists
InterlockedPopEntrySList
InterlockedPushEntrySList

 

 

Community Additions

ADD
Show:
© 2014 Microsoft