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
标头 interlockedapi.h (包括 Windows Server 2003 上的 Windows.h、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

InitializeSListHead

互锁的单独链接Lists

VBS enclave 中可用的 Vertdll API