Función QueryDepthSList (interlockedapi.h)

Recupera el número de entradas de la lista vinculada de forma singly especificada.

Sintaxis

USHORT QueryDepthSList(
  [in] PSLIST_HEADER ListHead
);

Parámetros

[in] ListHead

Puntero a una estructura SLIST_HEADER que representa el encabezado de una lista vinculada de forma singly. Esta estructura es solo para uso del sistema.

La lista debe inicializarse previamente con la función InitializeSListHead .

Valor devuelto

La función devuelve el número de entradas de la lista, hasta un valor máximo de 65535.

Comentarios

El sistema no limita el número de entradas de una lista vinculada singly. Sin embargo, el valor devuelto de QueryDepthSList se trunca a 16 bits, por lo que el valor máximo que puede devolver es 65535. Si la lista vinculada especificada contiene más de 65535 entradas, QueryDepthSList devuelve el número de entradas del módulo de lista 65535. Por ejemplo, si la lista especificada contiene 65536 entradas, QueryDepthSList devuelve cero.

No se debe confiar en el valor devuelto de QueryDepthSList en aplicaciones multiproceso porque otro subproceso puede cambiar el recuento de elementos en cualquier momento.

Requisitos

   
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado interlockedapi.h (incluye Windows.h en Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

InitializeSListHead

Interlocked Singly Linked Listas

API de Vertdll disponibles en enclaves de VBS