DSA_InsertItem, fonction (dpa_dsa.h)

[DSA_InsertItem est disponible pour une utilisation dans le fonctionnement

systèmes spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans

versions ultérieures.]

Insère un nouvel élément dans un tableau de structure dynamique (DSA). Si nécessaire, la DSA se développe pour prendre en charge le nouvel élément.

Syntaxe

int DSA_InsertItem(
  [in] HDSA       hdsa,
  [in] int        i,
  [in] const void *pitem
);

Paramètres

[in] hdsa

Type : HDSA

Handle de la DSA dans laquelle insérer l’élément.

[in] i

Type : int

Position dans la DSA où le nouvel élément doit être inséré, ou DSA_APPEND pour insérer l’élément à la fin du tableau.

[in] pitem

Type : void*

Pointeur vers l’élément à insérer.

Valeur retournée

Type : int

Retourne l’index du nouvel élément si l’insertion réussit, ou DSA_ERR (-1) si l’insertion échoue.

Remarques

Les données réelles pointées par pItem sont copiées dans le DSA. Les actions suivantes effectuées sur cet élément n’affectent pas la copie d’origine.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	dpa_dsa.h
Bibliothèque	Comctl32.lib
DLL	ComCtl32.dll
Ensemble d’API	ext-ms-win-shell-comctl32-da-l1-1-0 (introduit dans Windows 10, version 10.0.14393)