DSA_GetItemPtr function (dpa_dsa.h)

[DSA_GetItemPtr is available for use in the operating

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

subsequent versions.]

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

Syntax

PVOID DSA_GetItemPtr(
  [in] HDSA hdsa,
  [in] int  i
);

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

Return value

Returns a pointer to the specified element or NULL if the call fails.

Remarks

Using the element pointer that this function returns, 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
Library Comctl32.lib
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)