Функция QueryDepthSList (interlockedapi.h)

Извлекает количество записей в заданном списке, связанном по отдельности.

Синтаксис

USHORT QueryDepthSList(
  [in] PSLIST_HEADER ListHead
);

Параметры

[in] ListHead

Указатель на структуру SLIST_HEADER , представляющую заголовок последовательно связанного списка. Эта структура предназначена только для системного использования.

Список должен быть ранее инициализирован с помощью функции InitializeSListHead .

Возвращаемое значение

Функция возвращает количество записей в списке, вплоть до максимального значения 65535.

Комментарии

Система не ограничивает количество записей в отдельно связанном списке. Однако возвращаемое значение QueryDepthSList усекается до 16 бит, поэтому максимальное значение, которое он может вернуть, составляет 65535. Если указанный список содержит более 65535 записей, QueryDepthSList возвращает количество записей в списке по модулю 65535. Например, если указанный список содержит 65536 записей, QueryDepthSList возвращает ноль.

Возвращаемое значение QueryDepthSList не следует полагаться в многопоточных приложениях, так как число элементов может быть изменено в любое время другим потоком.

Требования

Минимальная версия клиента	Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	interlockedapi.h (включая Windows.h в Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

InitializesListHead

Interlocked Singly Linked Списки

API-интерфейсы Vertdll, доступные в анклавах VBS