QueryDepthSList 함수(interlockedapi.h)

지정된 연결 목록의 항목 수를 검색합니다.

구문

USHORT QueryDepthSList(
  [in] PSLIST_HEADER ListHead
);

매개 변수

[in] ListHead

연결된 목록의 헤드를 나타내는 SLIST_HEADER 구조체에 대한 포인터입니다. 이 구조는 시스템 전용입니다.

목록은 InitializeSListHead 함수를 사용하여 이전에 초기화되어야 합니다.

반환 값

함수는 최대 65535까지 목록의 항목 수를 반환합니다.

설명

시스템은 Singly 연결된 목록의 항목 수를 제한하지 않습니다. 그러나 QueryDepthSList 의 반환 값은 16비트로 잘리므로 반환할 수 있는 최대 값은 65535입니다. 지정된 singly 연결된 목록에 65535개 이상의 항목이 포함된 경우 QueryDepthSList 는 모듈로 65535 목록의 항목 수를 반환합니다. 예를 들어 지정된 목록에 65536 항목이 포함된 경우 QueryDepthSList 는 0을 반환합니다.

항목 수를 다른 스레드에서 언제든지 변경할 수 있으므로 QueryDepthSList 의 반환 값은 다중 스레드 애플리케이션에서 사용해서는 안 됩니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	interlockedapi.h(Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2의 Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll

참고 항목

InitializeSListHead

인터로킹된 Singly 연결된 Lists

VBS Enclave에서 사용할 수 있는 Vertdll API