Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

DSA_InsertItem function

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

Syntax


int WINAPI DSA_InsertItem(
  _In_ HDSA pdsa,
  _In_ int  index,
  _In_ void *pItem
);

Parameters

pdsa [in]

Type: HDSA

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

index [in]

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.

pItem [in]

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.

Remarks

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

Library

Comctl32.lib

DLL

ComCtl32.dll

 

 

Community Additions

ADD
Show:
© 2015 Microsoft