Funzione QueryDepthSList (interlockedapi.h)

Recupera il numero di voci nell'elenco collegato singly specificato.

Sintassi

USHORT QueryDepthSList(
  [in] PSLIST_HEADER ListHead
);

Parametri

[in] ListHead

Puntatore a una struttura SLIST_HEADER che rappresenta l'intestazione di un elenco collegato singly. Questa struttura è destinata solo all'uso del sistema.

L'elenco deve essere inizializzato in precedenza con la funzione InitializeSListHead .

Valore restituito

La funzione restituisce il numero di voci nell'elenco, fino a un valore massimo pari a 65535.

Commenti

Il sistema non limita il numero di voci in un elenco collegato singly. Tuttavia, il valore restituito di QueryDepthSList viene troncato a 16 bit, quindi il valore massimo che può restituire è 65535. Se l'elenco collegato specificato contiene più di 65535 voci, QueryDepthSList restituisce il numero di voci nel modulo elenco 65535. Ad esempio, se l'elenco specificato contiene 65536 voci, QueryDepthSList restituisce zero.

Il valore restituito di QueryDepthSList non deve essere basato su nelle applicazioni multithreading perché il conteggio degli elementi può essere modificato in qualsiasi momento da un altro thread.

Requisiti

Client minimo supportato	Windows XP [app desktop | App UWP]
Server minimo supportato	Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	interlockedapi.h (include Windows.h in Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

InitializeSListHead

Elenchi collegato singly bloccato

API Vertdll disponibili nelle enclave VBS