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 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Commctrl.h

Library

Comctl32.lib

DLL

ComCtl32.dll

 

 

Community Additions

ADD
Show:
© 2014 Microsoft