DSA_GetItemPtr function

[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


void* WINAPI DSA_GetItemPtr(
  _In_ HDSA pdsa,
  _In_ int  index
);

Parameters

pdsa [in]

Type: HDSA

A handle to the DSA containing the element.

index [in]

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Dpa_dsa.h

Library

Comctl32.lib

DLL

ComCtl32.dll (version 4.0 or later)

 

 

Show: