DdeAddData-Funktion (ddeml.h)

Artikel
02/26/2024

Fügt dem angegebenen DDE-Objekt (Dynamic Data Exchange) Daten hinzu. Eine Anwendung kann Daten ab einem beliebigen Offset vom Anfang des Objekts hinzufügen. Wenn neue Daten bereits im Objekt enthaltene Daten überlappen, überschreiben die neuen Daten die alten Daten in den Bytes, in denen die Überlappung auftritt. Der Inhalt von Speicherorten im -Objekt, in die nicht geschrieben wurde, ist nicht definiert.

Syntax

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

Parameter

[in] hData

Typ: HDDEDATA

Ein Handle für das DDE-Objekt, das zusätzliche Daten empfängt.

[in] pSrc

Typ: LPBYTE

Die Daten, die dem DDE-Objekt hinzugefügt werden sollen.

[in] cb

Art: DWORD

Die Länge der Daten, die dem DDE-Objekt hinzugefügt werden sollen, einschließlich des beendenden NULL, wenn es sich bei den Daten um eine Zeichenfolge handelt, in Bytes.

[in] cbOff

Art: DWORD

Ein Offset in Bytes vom Anfang des DDE-Objekts. Die zusätzlichen Daten werden ab diesem Offset in das Objekt kopiert.

Rückgabewert

Typ: HDDEDATA

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein neues Handle für das DDE-Objekt. Das neue Handle wird in allen Verweisen auf das -Objekt verwendet.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Die DdeGetLastError-Funktion kann verwendet werden, um den Fehlercode abzurufen, der einer der folgenden Werte sein kann:

Hinweise

Nachdem ein Datenhandle als Parameter in einer anderen Funktion der dynamischen Exchange-Verwaltungsbibliothek verwendet oder von einer DDE-Rückruffunktion zurückgegeben wurde, kann das Handle nur für den Lesezugriff auf das vom Handle identifizierte DDE-Objekt verwendet werden.

Wenn die ursprünglich zugewiesene Arbeitsspeichermenge kleiner ist, als für die hinzugefügten Daten erforderlich ist, ordnet DdeAddData ein globales Speicherobjekt der entsprechenden Größe um.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ddeml.h (Einschließen von Windows.h)
Bibliothek	User32.lib
DLL	User32.dll