Fonction de rappel PFNDPAMERGE (dpa_dsa.h)

Article
02/26/2024

Définit le prototype de la fonction de fusion utilisée par DPA_Merge.

Syntaxe

PFNDPAMERGE Pfndpamerge;

void * Pfndpamerge(
  [in] UINT uMsg,
  [in] void *pvDest,
  [in] void *pvSrc,
  [in] LPARAM lParam
)
{...}

Paramètres

[in] uMsg

Type : UINT

Message qui indique à cette fonction comment gérer la fusion. Une des valeurs suivantes.

Valeur	Signification
DPAMM_MERGE 0x1	Effectuez tout traitement supplémentaire nécessaire lors de la fusion de pvSrc dans pvDest. La fonction doit retourner un pointeur vers un élément qui contient le résultat de la fusion. La valeur retournée par la fonction de fusion est stockée dans la destination, qui remplace la valeur précédente. Si la fonction de fusion retourne NULL, l’opération de fusion est abandonnée.
DPAMM_DELETE 0x2	Effectuez tout traitement supplémentaire nécessaire lorsqu’une suppression se produit dans le cadre de la fusion. La fonction doit retourner NULL.
DPAMM_INSERT 0x3	Effectuez un traitement défini par l’utilisateur lorsque la fusion entraîne l’insertion d’un élément dans le cadre de la fusion. La valeur de retour de cette fonction doit pointer vers le résultat de l’élément qui est inséré dans le cadre de la fusion. Si la fonction de fusion retourne NULL, l’opération de fusion est abandonnée.

[in] pvDest

Type : void*

Pointeur vers le premier élément de la fusion.

[in] pvSrc

Type : void*

Pointeur vers le deuxième élément de la fusion.

[in] lParam

Type : LPARAM

Données supplémentaires qui peuvent être utilisées par le rappel de fusion.

Valeur retournée

Pointeur vers l’élément qui résulte de la fusion ou de la valeur NULL en cas d’échec lors de l’utilisation de DPAMM_MERGE ou de DPAMM_INSERT .

Remarques

La fonction de rappel peut ne pas modifier les tableaux de pointeurs dynamiques (DPA) impliqués dans l’opération de fusion.

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

Voir aussi

PFNDPAMERGECONST

Partager via