DPA_InsertPtr function (dpa_dsa.h)

[DPA_InsertPtr is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Inserts a new item at a specified position in a dynamic pointer array (DPA). If necessary, the DPA expands to accommodate the new item.

Syntax

int DPA_InsertPtr(
  HDPA hdpa,
  int  i,
  void *p
);

Parameters

hdpa

Type: HDPA

A handle to a DPA.

i

Type: int

Tbe position where new item is to be inserted.

p

Type: void*

A pointer to the item that is to be inserted.

Return value

Type: int

Returns the index of the new item or -1, if the insertion fails.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header dpa_dsa.h
Library Comctl32.lib
DLL ComCtl32.dll
API set ext-ms-win-shell-comctl32-da-l1-1-0 (introduced in Windows 10, version 10.0.14393)