Função QueryDepthSList (interlockedapi.h)

  • Artigo

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

Confira também

InitializeSListHead

Listas vinculados interligados

APIs Vertdll disponíveis em enclaves de VBS