Edit

DSA_GetItem function (dpa_dsa.h)

  • Article

Gets an element from a dynamic structure array (DSA).

Syntax

BOOL DSA_GetItem(
  [in]  HDSA hdsa,
  [in]  int  i,
  [out] void *pitem
);

Parameters

[in] hdsa

Type: HDSA

A handle to the DSA containing the element.

[in] i

Type: int

The index of the element to be retrieved (zero-based).

[out] pitem

Type: void*

A pointer to a buffer which is filled with a copy of the specified element of the DSA.

Return value

Type: BOOL

Returns TRUE if successful or FALSE otherwise.

Remarks

DSA_GetItem is not exported by name. To use it, you must use GetProcAddress and request ordinal 322 from ComCtl32.dll to obtain a function pointer.

Using the element pointer that this function retrieves, you can modify the data in that element directly. However, be aware that a subsequent insert or destroy operation could cause this pointer value to become invalid or to point to a different element.

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
DLL ComCtl32.dll (version 4.0 or later)
API set ext-ms-win-shell-comctl32-da-l1-1-0 (introduced in Windows 10, version 10.0.14393)

See also

DSA_GetItemPtr