DSA_GetItemPtr function (dpa_dsa.h)

Article
10/13/2021

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

Share via