DSA_AppendItem macro (dpa_dsa.h)

Appends a new item to the end of a dynamic structure array (DSA).

Syntax

int DSA_AppendItem(
  [in] HDSA hdsa,
  [in] void *pitem
);

Parameters

[in] hdsa

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

[in] pitem

A pointer to the item that is to be inserted.

Return value

Type: int

Returns the index of the new item if the append action succeeds, or -1 if the append action fails.

Remarks

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

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header dpa_dsa.h