Fonction DdeQueryConvInfo (ddeml.h)

Article
02/26/2024

Récupère des informations sur une transaction DDE (Dynamic Data Exchange) et sur la conversation dans laquelle la transaction a lieu.

Syntaxe

UINT DdeQueryConvInfo(
  [in]      HCONV     hConv,
  [in]      DWORD     idTransaction,
  [in, out] PCONVINFO pConvInfo
);

Paramètres

[in] hConv

Type : HCONV

Handle de la conversation.

[in] idTransaction

Type : DWORD

Transaction. Pour les transactions asynchrones, ce paramètre doit être un identificateur de transaction retourné par la fonction DdeClientTransaction . Pour les transactions synchrones, ce paramètre doit être QID_SYNC.

[in, out] pConvInfo

Type : PCONVINFO

Pointeur vers la structure CONVINFO qui reçoit des informations sur la transaction et la conversation. Le membre cb de la structure CONVINFO doit spécifier la longueur de la mémoire tampon allouée pour la structure.

Valeur retournée

Type : UINT

Si la fonction réussit, la valeur de retour correspond au nombre d’octets copiés dans la structure CONVINFO .

Si la fonction échoue, la valeur de retour est FALSE.

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

Remarques

Une application ne doit pas libérer un handle de chaîne référencé par la structure CONVINFO . Si une application doit utiliser l’un de ces handles de chaîne, elle doit appeler la fonction DdeKeepStringHandle pour créer une copie du handle.

Si le paramètre idTransaction a la valeur QID_SYNC, le membre hUser de la structure CONVINFO est associé à la conversation et peut être utilisé pour conserver les données associées à la conversation. Si idTransaction est l’identificateur d’une transaction asynchrone, le membre hUser est associé uniquement à la transaction actuelle et est valide uniquement pour la durée de la transaction.

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