QueryDepthSList-Funktion (interlockedapi.h)

Ruft die Anzahl der Einträge in der angegebenen liste ab.

Syntax

USHORT QueryDepthSList(
  [in] PSLIST_HEADER ListHead
);

Parameter

[in] ListHead

Ein Zeiger auf eine SLIST_HEADER Struktur, die den Kopf einer eng verknüpften Liste darstellt. Diese Struktur ist nur für die Systemverwendung vorgesehen.

Die Liste muss zuvor mit der InitializeSListHead-Funktion initialisiert werden.

Rückgabewert

Die Funktion gibt die Anzahl der Einträge in der Liste zurück, bis zu einem maximalen Wert von 65535.

Hinweise

Das System schränkt die Anzahl der Einträge in einer singly verknüpften Liste nicht ein. Der Rückgabewert von QueryDepthSList wird jedoch auf 16 Bits gekürzt, sodass der maximal zurückgegebene Wert 65535 ist. Wenn die angegebene liste mehr als 65535 Einträge enthält, gibt QueryDepthSList die Anzahl der Einträge im Listenmodulo 65535 zurück. Wenn die angegebene Liste beispielsweise 65536 Einträge enthält, gibt QueryDepthSList null zurück.

Der Rückgabewert von QueryDepthSList sollte in Multithreadanwendungen nicht verwendet werden, da die Elementanzahl jederzeit von einem anderen Thread geändert werden kann.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	interlockedapi.h (einschließlich Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

InitializeSListHead

Interlocked Singly Linked Listen

In VBS-Enclaves verfügbare Vertdll-APIs