Funzione DdeAddData (ddeml.h)

Articolo
02/26/2024

Aggiunge dati all'oggetto DDE (Dynamic Data Exchange) specificato. Un'applicazione può aggiungere dati a partire da qualsiasi offset dall'inizio dell'oggetto. Se i nuovi dati si sovrappongono già nell'oggetto, i nuovi dati sovrascrivono i dati precedenti nei byte in cui si verifica la sovrapposizione. Il contenuto delle posizioni nell'oggetto a cui non è stato scritto è indefinito.

Sintassi

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

Parametri

[in] hData

Tipo: HDDEDATA

Handle per l'oggetto DDE che riceve dati aggiuntivi.

[in] pSrc

Tipo: LPBYTE

Dati da aggiungere all'oggetto DDE.

[in] cb

Tipo: DWORD

Lunghezza, in byte, dei dati da aggiungere all'oggetto DDE, inclusa la terminazione NULL, se i dati sono una stringa.

[in] cbOff

Tipo: DWORD

Offset, in byte, dall'inizio dell'oggetto DDE. I dati aggiuntivi vengono copiati nell'oggetto a partire da questo offset.

Valore restituito

Tipo: HDDEDATA

Se la funzione ha esito positivo, il valore restituito è un nuovo handle per l'oggetto DDE. Il nuovo handle viene usato in tutti i riferimenti all'oggetto.

Se la funzione ha esito negativo, il valore restituito è zero.

La funzione DdeGetLastError può essere usata per ottenere il codice di errore, che può essere uno dei valori seguenti:

Commenti

Dopo che un handle dati è stato usato come parametro in un'altra funzione libreria di gestione di Dynamic Data Exchange o è stata restituita da una funzione di callback DDE, l'handle può essere usato solo per l'accesso in lettura all'oggetto DDE identificato dall'handle.

Se la quantità di memoria originariamente allocata è minore di quella necessaria per contenere i dati aggiunti, DdeAddData rialloca un oggetto memoria globale delle dimensioni appropriate.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ddeml.h (includere Windows.h)
Libreria	User32.lib
DLL	User32.dll