DSA_GetItem function (dpa_dsa.h)

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

See also

DSA_GetItemPtr