Função InitAtomTable (winbase.h)
Inicializa a tabela atom local e define o número de buckets de hash para o tamanho especificado.
Sintaxe
BOOL InitAtomTable(
[in] DWORD nSize
);
Parâmetros
[in] nSize
Tipo: DWORD
O número de buckets de hash a serem usados para a tabela atom. Se esse parâmetro for zero, o número padrão de buckets de hash será criado.
Para obter um melhor desempenho, especifique um número primo em nSize.
Retornar valor
Tipo: BOOL
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero.
Comentários
Um aplicativo não precisa usar essa função para usar uma tabela atom local. O número padrão de buckets de hash usados é 37. No entanto, se um aplicativo usar InitAtomTable, ele deverá chamar a função antes de qualquer outra função de gerenciamento atom.
Se um aplicativo usa um grande número de átomos locais, ele pode reduzir o tempo necessário para adicionar um átomo à tabela atom local ou para encontrar um átomo na tabela aumentando o tamanho da tabela. No entanto, isso aumenta a quantidade de memória necessária para manter a tabela.
O número de buckets na tabela atom global não pode ser alterado. Se a tabela atom já tiver sido inicializada, explicitamente por uma chamada anterior a InitAtomTable ou implicitamente pelo uso de qualquer função de gerenciamento atom, InitAtomTable retornará êxito sem alterar o número de buckets de hash.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winbase.h (incluir Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |
Confira também
Referência