DSA_InsertItem function (dpa_dsa.h)

[DSA_InsertItem 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 into a dynamic structure array (DSA). If necessary, the DSA expands to accommodate the new item.


int DSA_InsertItem(
  [in] HDSA       hdsa,
  [in] int        i,
  [in] const void *pitem


[in] hdsa

Type: HDSA

A handle to the DSA in which to insert the item.

[in] i

Type: int

The position in the DSA where new item is to be inserted, or DSA_APPEND to insert the item at the end of the array.

[in] pitem

Type: void*

A pointer to the item that is to be inserted.

Return value

Type: int

Returns the index of the new item if the insertion succeeds, or DSA_ERR (-1) if the insertion fails.


The actual data pointed to by pItem is copied into the DSA. Subsequent actions performed on that item do not affect the original copy.


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)