| Home | Table of Contents | Please view with Internet Explorer (version 5.00 or higher) and enable scripting. For reasons, see Browsing This Web Site. |
This function creates a dynamic pointer array.
HDPA DPA_Create (int cpGrow);
The cpGrow argument provides the allocation unit for the DPA, measured as a number of pointers.
The function returns a handle to the DPA if successful, else NULL for failure.
The DPA handle is the address of a 14h-byte control structure also named DPA. Memory for the control structure is obtained from the process heap in the NT implementations, else a private heap in the Windows implementations.
Memory for the pointer array itself is not obtained by this function. Instead, the memory block that contains the array grows and shrinks according to the demands of other functions, but always as a multiple of an allocation unit whose initial size is set from the cpGrow argument. This allocation unit has an effective minimum of eight: the function chooses eight as the allocation unit if given any lesser value.
The DPA_Create function is exported from COMCTL32.DLL as ordinal 328 in version 3.50 and higher.
This function was documented among the Settlement Program Interfaces in December 2002, but with Windows 2000 cited as the minimum operating system, despite many years of earlier availability.