Função QueryDepthSList (interlockedapi.h)
Recupera o número de entradas na lista vinculada de forma singly especificada.
Sintaxe
USHORT QueryDepthSList(
[in] PSLIST_HEADER ListHead
);
Parâmetros
[in] ListHead
Um ponteiro para uma estrutura SLIST_HEADER que representa o cabeçalho de uma lista vinculada. Essa estrutura destina-se apenas ao uso do sistema.
A lista deve ser inicializada anteriormente com a função InitializeSListHead .
Retornar valor
A função retorna o número de entradas na lista, até um valor máximo de 65535.
Comentários
O sistema não limita o número de entradas em uma lista vinculada. No entanto, o valor retornado de QueryDepthSList é truncado para 16 bits, portanto, o valor máximo que ele pode retornar é 65535. Se a lista vinculada especificada contiver mais de 65535 entradas, QueryDepthSList retornará o número de entradas no módulo de lista 65535. Por exemplo, se a lista especificada contiver 65536 entradas, QueryDepthSList retornará zero.
O valor retornado de QueryDepthSList não deve ser confiado em aplicativos multithread porque a contagem de itens pode ser alterada a qualquer momento por outro thread.
Requisitos
| Cliente mínimo com suporte | Windows XP [aplicativos da área de trabalho | aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | interlockedapi.h (inclua Windows.h no Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |