Edit

Share via

DSA_Create function (dpa_dsa.h)

  • Article

[DSA_Create is available for use in the operating

systems specified in the Requirements section. It may be altered or unavailable in

subsequent versions.]

Creates a dynamic structure array (DSA).

Syntax

HDSA DSA_Create(
  [in] int cbItem,
  [in] int cItemGrow
);

Parameters

[in] cbItem

Type: int

The size, in bytes, of the item.

[in] cItemGrow

Type: int

The number of items by which the array should be incremented, if the DSA needs to be enlarged.

Return value

Type: HDSA

Returns a handle to a DSA if successful, or NULL if the creation fails.

Remarks

Unlike a dynamic pointer array (DPA), a DSA can contain elements of any size. This allows structures to be stored directly in the array.

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)