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

另請參閱

InitializeSListHead

內嵌式連結 清單

VBS 記憶體保護區中可用的 Vertdll API