DPA_Grow function (dpa_dsa.h)

Changes the number of pointers in a dynamic pointer array (DPA).

Syntax

BOOL DPA_Grow(
  [in] HDPA pdpa,
  [in] int  cp
);

Parameters

[in] pdpa

Type: HDPA

A handle to an existing DPA.

[in] cp

Type: int

The number of pointers desired in the DPA.

Return value

Type: BOOL

Returns TRUE if successful, or FALSE otherwise.

Remarks

If cp is less than the number of pointers already in the DPA, the DPA is left unchanged. If cp is greater than the number of pointers in the DPA, the added pointers are initialized to NULL.

Requirements