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

関連項目

AddAtom

DeleteAtom

FindAtom

GetAtomName

GlobalAddAtom

GlobalDeleteAtom

GlobalFindAtom

GlobalGetAtomName

参照