DPA_GetPtrPtr macro

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

Syntax


void DPA_GetPtrPtr(
  [in]  HDPA hdpa
);

Parameters

hdpa [in]

A handle to an existing DPA.

Return value

Returns a pointer to the array of pointers managed by the DPA. To retrieve the number of pointers in the array, call macro DPA_GetPtrCount.

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Commctrl.h

 

 

Community Additions

ADD
Show:
© 2015 Microsoft