This topic has not yet been rated - Rate this topic

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

C++


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 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Commctrl.h
Library	Comctl32.lib
DLL	ComCtl32.dll (version 4.0 or later)

Send comments about this topic to Microsoft

Build date: 10/27/2012

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD