Fonction DdeAddData (ddeml.h)

Article
02/29/2024

Ajoute des données à l’objet DDE (Dynamic Data Exchange) spécifié. Une application peut ajouter des données à partir de n’importe quel décalage à partir du début de l’objet. Si de nouvelles données chevauchent des données déjà dans l’objet, les nouvelles données remplacent les anciennes données dans les octets où le chevauchement se produit. Le contenu des emplacements dans l’objet qui n’ont pas été écrits dans n’est pas défini.

Syntaxe

HDDEDATA DdeAddData(
  [in] HDDEDATA hData,
  [in] LPBYTE   pSrc,
  [in] DWORD    cb,
  [in] DWORD    cbOff
);

Paramètres

[in] hData

Type : HDDEDATA

Handle de l’objet DDE qui reçoit des données supplémentaires.

[in] pSrc

Type : LPBYTE

Données à ajouter à l’objet DDE.

[in] cb

Type : DWORD

Longueur, en octets, des données à ajouter à l’objet DDE, y compris la valeur NULL de fin, si les données sont une chaîne.

[in] cbOff

Type : DWORD

Décalage, en octets, du début de l’objet DDE. Les données supplémentaires sont copiées dans l’objet à partir de ce décalage.

Valeur retournée

Type : HDDEDATA

Si la fonction réussit, la valeur de retour est un nouveau handle pour l’objet DDE. Le nouveau handle est utilisé dans toutes les références à l’objet .

Si la fonction échoue, la valeur de retour est égale à zéro.

La fonction DdeGetLastError peut être utilisée pour obtenir le code d’erreur, qui peut être l’une des valeurs suivantes :

Remarques

Une fois qu’un handle de données a été utilisé comme paramètre dans une autre fonction de bibliothèque de gestion Dynamic Data Exchange ou qu’il a été retourné par une fonction de rappel DDE, le handle peut être utilisé uniquement pour l’accès en lecture à l’objet DDE identifié par le handle.

Si la quantité de mémoire allouée à l’origine est inférieure à celle nécessaire pour contenir les données ajoutées, DdeAddData réalloue un objet mémoire global de la taille appropriée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ddeml.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll