CAtlMap::InitHashTable

Call this method to initialize the hash table.

bool InitHashTable(
   UINT nBins,
   bool bAllocNow = true 
);

Parameters

  • nBins
    The number of bins used by the hash table. See CAtlMap::CAtlMap for an explanation.

  • bAllocNow
    A flag indication when memory should be allocated.

Return Value

Returns true on successful initialization, false on failure.

Remarks

InitHashTable must be called before any elements are stored in the hash table. If this method is not called explicitly, it will be called automatically the first time an element is added using the bin count specified by the CAtlMap constructor. Otherwise, the map will be initialized using the new bin count specified by the nBins parameter.

If the bAllocNow parameter is false, the memory required by the hash table will not be allocated until it is first required. This can be useful if it is uncertain if the map will be used.

Example

See the example for CAtlMap::CAtlMap.

Requirements

Header: atlcoll.h

See Also

Concepts

CAtlMap Class

CAtlMap Members