DPA_GetPtrPtr macro (dpa_dsa.h)

Gets the pointer to the internal pointer array of a dynamic pointer array (DPA).

Syntax

void DPA_GetPtrPtr(
  [in] HDPA hdpa
);

Parameters

[in] hdpa

A handle to an existing DPA.

Return value

None

Remarks

Applications can use the return value to manipulate the contents of the DPA directly instead of using functions such as DPA_SetPtr. The return value is invalidated by any operation that changes the number of elements in the DPA or destroys the DPA. For example, after calling function DPA_InsertPtr on a DPA, any internal pointers retrieved by calling the macro DPA_GetPtrPtr on the same DPA are no longer valid.

Requirements