Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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.

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

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

 

 

Show:
© 2017 Microsoft