Structure CONVINFO (ddeml.h)

Article
08/23/2023

Contient des informations sur une conversation DDE (Dynamic Data Exchange).

Syntaxe

typedef struct tagCONVINFO {
  DWORD       cb;
  DWORD_PTR   hUser;
  HCONV       hConvPartner;
  HSZ         hszSvcPartner;
  HSZ         hszServiceReq;
  HSZ         hszTopic;
  HSZ         hszItem;
  UINT        wFmt;
  UINT        wType;
  UINT        wStatus;
  UINT        wConvst;
  UINT        wLastError;
  HCONVLIST   hConvList;
  CONVCONTEXT ConvCtxt;
  HWND        hwnd;
  HWND        hwndPartner;
} CONVINFO, *PCONVINFO;

Membres

cb

Type : DWORD

Taille de la structure, en octets.

hUser

Type : DWORD_PTR

Données définies par l’application.

hConvPartner

Type : HCONV

Handle de l’application partenaire dans la conversation DDE. Ce membre est égal à zéro si le partenaire ne s’est pas inscrit (à l’aide de la fonction DdeInitialize ) pour effectuer des appels de fonction DDEML. Une application ne doit pas passer ce membre à une fonction DDEML à l’exception de DdeQueryConvInfo.

hszSvcPartner

Type : HSZ

Handle du nom de service de l’application partenaire.

hszServiceReq

Type : HSZ

Handle du nom de service de l’application serveur demandée pour la connexion.

hszTopic

Type : HSZ

Handle du nom de la rubrique demandée.

hszItem

Type : HSZ

Handle du nom de l’élément demandé. Ce membre est spécifique à la transaction.

wFmt

Type : UINT

Format des données échangées. Ce membre est spécifique à la transaction.

wType

Type : UINT

Type de la transaction actuelle. Ce membre est spécifique à la transaction ; il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
XTYP_ADVDATA 0x4010	Informe un client qui indique que les données d’un serveur sont arrivées.
XTYP_ADVREQ 0x2022	Demande à un serveur d’envoyer des données mises à jour au client pendant une boucle d’avis. Cette transaction se produit lorsque le serveur appelle DdePostAdvise.
XTYP_ADVSTART 0x1030	Demande à un serveur de commencer une boucle d’avertissement avec un client.
XTYP_ADVSTOP 0x8040	Avertit un serveur qu’une boucle d’avertissement s’arrête.
XTYP_CONNECT 0x1062	Demande à un serveur d’établir une conversation avec un client.
XTYP_CONNECT_CONFIRM 0x8072	Avertit un serveur qu’une conversation avec un client a été établie.
XTYP_DISCONNECT 0x80C2	Avertit un serveur qu’une conversation s’est terminée.
XTYP_EXECUTE 0x4050	Demande à un serveur d’exécuter une commande envoyée par un client.
XTYP_MONITOR 0x80F2	Avertit une application inscrite en tant que APPCMD_MONITOR que des données DDE sont transmises.
XTYP_POKE 0x4090	Demande à un serveur d’accepter les données non sollicitées d’un client.
XTYP_REGISTER 0x80A2	Avertit les autres applications DDEML qu’un serveur a inscrit un nom de service.
XTYP_REQUEST 0x20B0	Demande à un serveur d’envoyer des données à un client.
XTYP_UNREGISTER 0x80D2	Avertit d’autres applications DDEML qu’un serveur a désinscrit un nom de service.
XTYP_WILDCONNECT 0x20E2	Demande à un serveur d’établir plusieurs conversations avec le même client.
XTYP_XACT_COMPLETE 0x8080	Avertit un client qu’une transaction de données asynchrone a été effectuée.

wStatus

Type : UINT

Status de la conversation actuelle. Ce membre peut être une ou plusieurs des valeurs suivantes.

Valeur	Signification
ST_ADVISE 0x0002	Un ou plusieurs liens sont en cours.
ST_BLOCKED 0x0008	La conversation est bloquée.
ST_BLOCKNEXT 0x0080	La conversation sera bloquée après l’appel du rappel suivant.
ST_CLIENT 0x0010	Le handle con0x0010versation passé à la fonction DdeQueryConvInfo est un handle côté client. Si le handle est égal à zéro, le handle de conversation passé à la fonction DdeQueryConvInfo est un handle côté serveur.
ST_CONNECTED 0x0001	La conversation est connectée.
ST_INLIST 0x0040	La conversation est membre d’une liste de conversations.
ST_ISLOCAL 0x0004	Les deux côtés de la conversation utilisent le DDEML.
ST_ISSELF 0x0100	Les deux côtés de la conversation utilisent la même instance du DDEML.
ST_TERMINATED 0x0020	La conversation a été interrompue par le partenaire.

wConvst

Type : UINT

État de la conversation. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
XST_ADVACKRCVD 13	La transaction de conseil vient d’être terminée.
XST_ADVDATAACKRCVD 16	La transaction de données de conseil vient d’être terminée.
XST_ADVDATASENT 15	Les données d’avis ont été envoyées et sont en attente d’un accusé de réception.
XST_ADVSENT 11	Une transaction d’avis est en attente d’un accusé de réception.
XST_CONNECTED 2	La conversation n’a pas de transactions actives.
XST_DATARCVD 6	Les données demandées viennent d’être reçues.
XST_EXECACKRCVD 10	Une transaction d’exécution vient d’être effectuée.
XST_EXECSENT 9	Une transaction d’exécution attend un accusé de réception.
XST_INCOMPLETE 1	La dernière transaction a échoué.
XST_INIT1 3	État d’initialisation intermédiaire 1.
XST_INIT2 4	État d’initialisation intermédiaire 2.
XST_NULL 0	État de pré-lancement.
XST_POKEACKRCVD 8	Une transaction d’poke vient d’être effectuée.
XST_POKESENT 7	Une transaction poke est en attente d’un accusé de réception.
XST_REQSENT 5	Une transaction de demande est en attente d’un accusé de réception.
XST_UNADVACKRCVD 14	Une transaction de désadvise vient d’être effectuée.
XST_UNADVSENT 12	Une transaction de désadvise est en attente d’un accusé de réception.

wLastError

Type : UINT

Valeur d’erreur associée à la dernière transaction.

hConvList

Type : HCONVLIST

Handle de la liste des conversations si le handle de la conversation actuelle se trouve dans une liste de conversations. Ce membre a la valeur NULL si la conversation ne figure pas dans une liste de conversations.

ConvCtxt

Type : CONVCONTEXT

Contexte de conversation.

hwnd

Type : HWND

Handle vers la fenêtre de l’application appelante impliquée dans la conversation.

hwndPartner

Type : HWND

Handle vers la fenêtre de l’application partenaire impliquée dans la conversation actuelle.

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]
En-tête	ddeml.h (inclure Windows.h)