initAtomTable 函式 (winbase.h)

初始化本機 Atom 數據表，並將哈希值區的數目設定為指定的大小。

語法

BOOL InitAtomTable(
  [in] DWORD nSize
);

[in] nSize

類型： DWORD

要用於 Atom 數據表的哈希值區數目。如果此參數為零，則會建立預設的哈希值區數目。

若要達到更好的效能，請在 nSize 中指定質數。

類型： BOOL

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。

應用程式不需要使用此函式來使用本機 Atom 數據表。使用的預設哈希值區數目為 37。不過，如果應用程式使用 InitAtomTable，它應該在任何其他 Atom 管理函式之前呼叫函式。

如果應用程式使用大量本機 Atom，它可以減少將 Atom 新增至本機 Atom 數據表或藉由增加數據表大小來尋找數據表中的 Atom 所需的時間。不過，這會增加維護數據表所需的記憶體數量。

無法變更全域 Atom 數據表中的貯體數目。如果 Atom 數據表已經初始化，則由先前呼叫 InitAtomTable 明確初始化，或是透過使用任何 atom-management 函式隱含的方式， InitAtomTable 會傳回成功，而不會變更哈希值區的數目。