QueryDepthSList 関数 (interlockedapi.h)
指定した 1 つのリンクリスト内のエントリの数を取得します。
構文
USHORT QueryDepthSList(
[in] PSLIST_HEADER ListHead
);
パラメーター
[in] ListHead
1 つのリンクされたリストの先頭を表す SLIST_HEADER 構造体へのポインター。 この構造は、システムでのみ使用されます。
リストは、 InitializeSListHead 関数を使用して以前に初期化する必要があります。
戻り値
この関数は、リスト内のエントリの数 (最大値は 65535) を返します。
注釈
1 つのリンクリスト内のエントリの数は制限されません。 ただし、 QueryDepthSList の戻り値は 16 ビットに切り捨てられるため、返すことができる最大値は 65535 です。 指定した 1 つのリンク リストに 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 を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |