Windows Dev Center

DSA_GetItem function

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

Syntax


BOOL WINAPI DSA_GetItem(
  _In_  HDSA pdsa,
  _In_  int  index,
  _Out_ void *pitem
);

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

pitem [out]

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

DLL

ComCtl32.dll (version 4.0 or later)

See also

DSA_GetItemPtr

 

 

Community Additions

ADD
Show:
© 2015 Microsoft