Fungsi QueryDepthSList (interlockedapi.h)

  • Artikel

Mengambil jumlah entri dalam daftar yang ditautkan secara senyap yang ditentukan.

Sintaks

USHORT QueryDepthSList(
  [in] PSLIST_HEADER ListHead
);

Parameter

[in] ListHead

Penunjuk ke struktur SLIST_HEADER yang mewakili kepala daftar yang ditautkan secara senyap. Struktur ini hanya untuk penggunaan sistem.

Daftar sebelumnya harus diinisialisasi dengan fungsi InitializeSListHead .

Menampilkan nilai

Fungsi mengembalikan jumlah entri dalam daftar, hingga nilai maksimum 65535.

Keterangan

Sistem tidak membatasi jumlah entri dalam daftar yang ditautkan. Namun, nilai pengembalian QueryDepthSList dipotok menjadi 16 bit, sehingga nilai maksimum yang dapat dikembalikan adalah 65535. Jika daftar yang ditautkan secara senyap yang ditentukan berisi lebih dari 65535 entri, QueryDepthSList mengembalikan jumlah entri dalam modul daftar 65535. Misalnya, jika daftar yang ditentukan berisi 65536 entri, QueryDepthSList mengembalikan nol.

Nilai pengembalian QueryDepthSList tidak boleh diandalkan dalam aplikasi multithread karena jumlah item dapat diubah kapan saja oleh utas lain.

Persyaratan

   
Klien minimum yang didukung Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header interlockedapi.h (termasuk Windows.h pada Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

InitializeSListHead

Lists Tertaut Senyap Yang Saling Terhubung

API Vertdll tersedia di enklave VBS