Funzione DdeCreateDataHandle (ddeml.h)

Articolo
08/23/2023

Crea un oggetto DDE (Dynamic Data Exchange) e riempie l'oggetto con dati dal buffer specificato. Un'applicazione DDE usa questa funzione durante le transazioni che comportano il passaggio dei dati all'applicazione partner.

Sintassi

HDDEDATA DdeCreateDataHandle(
  [in]           DWORD  idInst,
  [in, optional] LPBYTE pSrc,
  [in]           DWORD  cb,
  [in]           DWORD  cbOff,
  [in, optional] HSZ    hszItem,
  [in]           UINT   wFmt,
  [in]           UINT   afCmd
);

Parametri

[in] idInst

Tipo: DWORD

Identificatore dell'istanza dell'applicazione ottenuto da una chiamata precedente alla funzione DdeInitialize .

[in, optional] pSrc

Tipo: LPBYTE

Dati da copiare nell'oggetto DDE. Se questo parametro è NULL, nessun dato viene copiato nell'oggetto.

[in] cb

Tipo: DWORD

Quantità di memoria, in byte, da copiare dal buffer a cui punta da pSrc. (includere null di terminazione, se i dati sono una stringa). Se questo parametro è zero, il parametro pSrc viene ignorato.

[in] cbOff

Tipo: DWORD

Offset, in byte, dall'inizio del buffer a cui punta il parametro pSrc . I dati a partire da questo offset vengono copiati dal buffer all'oggetto DDE.

[in, optional] hszItem

Tipo: HSZ

Handle alla stringa che specifica l'elemento di dati corrispondente all'oggetto DDE. Questo handle deve essere stato creato da una chiamata precedente alla funzione DdeCreateStringHandle . Se l'handle dati deve essere usato in una transazione XTYP_EXECUTE , questo parametro deve essere 0L.

[in] wFmt

Tipo: UINT

Formato standard degli Appunti dei dati.

[in] afCmd

Tipo: UINT

Flag di creazione. Questo parametro può essere HDATA_APPOWNED, che specifica che l'applicazione server che chiama la funzione DdeCreateDataHandle possiede l'handle dati creato da questa funzione. Questo flag consente all'applicazione di condividere l'handle dati con altre applicazioni DDEML anziché creare un handle separato da passare a ogni applicazione. Se questo flag viene specificato, l'applicazione deve infine liberare l'oggetto memoria condivisa associato all'handle usando la funzione DdeFreeDataHandle . Se questo flag non è specificato, l'handle diventa non valido nell'applicazione che ha creato l'handle dopo che l'handle di dati viene restituito dalla funzione di callback DDE dell'applicazione o viene usato come parametro in un'altra funzione DDEML.

Valore restituito

Tipo: HDDEDATA

Se la funzione ha esito positivo, il valore restituito è un handle dati.

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

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

Commenti

Tutte le posizioni non compilate nell'oggetto DDE non sono definito.

Dopo l'uso di un handle di dati come parametro in un'altra funzione DDEML o restituito da una funzione di callback DDE, l'handle può essere usato solo per l'accesso in lettura all'oggetto DDE identificato dall'handle.

Requisiti


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