InitializeSListHead function (interlockedapi.h)

Initializes the head of a singly linked list.

Syntax

void InitializeSListHead(
  [in, out] PSLIST_HEADER ListHead
);

Parameters

[in, out] ListHead

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

None

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 Interlocked Singly Linked Lists.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps | UWP apps]
Minimum supported server Windows Server 2003 [desktop apps | UWP apps]
Target Platform Windows
Header interlockedapi.h (include Windows.h on Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library Kernel32.lib
DLL Kernel32.dll

See also

Interlocked Singly Linked Lists

InterlockedPopEntrySList

InterlockedPushEntrySList

Vertdll APIs available in VBS enclaves