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 |