Fonction DdeCreateDataHandle (ddeml.h)

Article
08/23/2023

Crée un objet DDE (Dynamic Data Exchange) et remplit l’objet avec des données de la mémoire tampon spécifiée. Une application DDE utilise cette fonction lors des transactions qui impliquent le passage de données à l’application partenaire.

Syntaxe

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
);

Paramètres

[in] idInst

Type : DWORD

L’application instance identificateur obtenu par un appel précédent à la fonction DdeInitialize.

[in, optional] pSrc

Type : LPBYTE

Données à copier dans l’objet DDE. Si ce paramètre a la valeur NULL, aucune donnée n’est copiée dans l’objet.

[in] cb

Type : DWORD

Quantité de mémoire, en octets, à copier à partir de la mémoire tampon pointée par pSrc. (incluez la valeur NULL de fin, si les données sont une chaîne). Si ce paramètre est égal à zéro, le paramètre pSrc est ignoré.

[in] cbOff

Type : DWORD

Décalage, en octets, du début de la mémoire tampon pointée vers le paramètre pSrc . Les données commençant à ce décalage sont copiées de la mémoire tampon vers l’objet DDE.

[in, optional] hszItem

Type : HSZ

Handle de la chaîne qui spécifie l’élément de données correspondant à l’objet DDE. Ce handle doit avoir été créé par un appel précédent à la fonction DdeCreateStringHandle . Si le handle de données doit être utilisé dans une transaction de XTYP_EXECUTE , ce paramètre doit être de 0L.

[in] wFmt

Type : UINT

Format standard du Presse-papiers des données.

[in] afCmd

Type : UINT

Indicateurs de création. Ce paramètre peut être HDATA_APPOWNED, ce qui spécifie que l’application serveur appelant la fonction DdeCreateDataHandle est propriétaire du handle de données créé par cette fonction. Cet indicateur permet à l’application de partager le handle de données avec d’autres applications DDEML plutôt que de créer un handle distinct à transmettre à chaque application. Si cet indicateur est spécifié, l’application doit libérer l’objet de mémoire partagée associé au handle à l’aide de la fonction DdeFreeDataHandle . Si cet indicateur n’est pas spécifié, le handle devient non valide dans l’application qui a créé le handle une fois que le handle de données a été retourné par la fonction de rappel DDE de l’application ou est utilisé comme paramètre dans une autre fonction DDEML.

Valeur retournée

Type : HDDEDATA

Si la fonction réussit, la valeur de retour est un handle de données.

Si la fonction échoue, la valeur de retour est 0L.

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

Notes

Tous les emplacements non remplis dans l’objet DDE ne sont pas définis.

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

Spécifications


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