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 |
|