Partager via

Structure CONVINFO (ddeml.h)

  • Article

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)

Voir aussi

CONVCONTEXT

Conceptuel

DdeInitialize

DdePostAdvise

DdeQueryConvInfo

Bibliothèque de gestion Dynamic Data Exchange

Référence