Función InitAtomTable (winbase.h)
Inicializa la tabla atom local y establece el número de cubos hash en el tamaño especificado.
Sintaxis
BOOL InitAtomTable(
[in] DWORD nSize
);
Parámetros
[in] nSize
Tipo: DWORD
Número de cubos hash que se van a usar para la tabla atom. Si este parámetro es cero, se crea el número predeterminado de cubos hash.
Para lograr un mejor rendimiento, especifique un número primo en nSize.
Valor devuelto
Tipo: BOOL
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero.
Comentarios
Una aplicación no necesita usar esta función para usar una tabla atom local. El número predeterminado de cubos hash usados es 37. Sin embargo, si una aplicación usa InitAtomTable, debe llamar a la función antes de cualquier otra función de administración de atom.
Si una aplicación usa un gran número de átomos locales, puede reducir el tiempo necesario para agregar un átomo a la tabla atom local o para encontrar un átomo en la tabla aumentando el tamaño de la tabla. Sin embargo, esto aumenta la cantidad de memoria necesaria para mantener la tabla.
No se puede cambiar el número de cubos de la tabla atom global. Si la tabla atom ya se ha inicializado, ya sea explícitamente mediante una llamada anterior a InitAtomTable o implícitamente por el uso de cualquier función de administración de atom, InitAtomTable devuelve éxito sin cambiar el número de cubos hash.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winbase.h (incluye Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |
Vea también
Referencia