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 Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |