InitAtomTable 関数 (winbase.h)
ローカル atom テーブルを初期化し、ハッシュ バケットの数を指定したサイズに設定します。
構文
BOOL InitAtomTable(
[in] DWORD nSize
);
パラメーター
[in] nSize
型: DWORD
atom テーブルに使用するハッシュ バケットの数。 このパラメーターが 0 の場合、ハッシュ バケットの既定の数が作成されます。
パフォーマンスを向上させるには、 nSize に素数を指定します。
戻り値
種類: BOOL
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。
注釈
アプリケーションでは、ローカル atom テーブルを使用するためにこの関数を使用する必要はありません。 使用されるハッシュ バケットの既定の数は 37 です。 ただし、アプリケーションで InitAtomTable を使用する場合は、他の atom-management 関数の前に 関数を呼び出す必要があります。
アプリケーションで多数のローカル原子を使用する場合、テーブルのサイズを大きくすることで、ローカルアトムテーブルにアトムを追加したり、テーブル内のアトムを見つけるのに必要な時間を短縮できます。 ただし、これにより、テーブルを維持するために必要なメモリの量が増えます。
グローバルアトムテーブルのバケット数は変更できません。 Atom テーブルが既に初期化されている場合は、 InitAtomTable の以前の呼び出しによって明示的に初期化されているか、atom-management 関数を使用して暗黙的に初期化されている場合、 InitAtomTable はハッシュ バケットの数を変更せずに成功を返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winbase.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |
関連項目
参照