XTYP_WILDCONNECT transaction

Article
07/03/2023

Permet à un client d’établir une conversation sur chacune des paires nom de service et nom de rubrique du serveur qui correspondent au nom de service et au nom de la rubrique spécifiés. Une fonction de rappel de serveur DDE (Dynamic Data Exchange), DdeCallback, reçoit cette transaction lorsqu’un client spécifie un nom de service NULL , un nom de rubrique NULL ou les deux dans un appel à la fonction DdeConnect ou DdeConnectList .

#define     XCLASS_DATA              0x2000
#define     XTYPF_NOBLOCK            0x0002
#define     XTYP_WILDCONNECT        (0x00E0 | XCLASS_DATA | XTYPF_NOBLOCK)

Paramètres

uType: Type de transaction.
uFmt: Non utilisé.
hconv: Non utilisé.
hsz1: Handle du nom de la rubrique. Si ce paramètre a la valeur NULL, le client demande une conversation sur tous les noms de rubriques pris en charge par le serveur.
hsz2: Handle du nom du service. Si ce paramètre a la valeur NULL, le client demande une conversation sur tous les noms de service pris en charge par le serveur.
hdata: Non utilisé.
dwData1: Pointeur vers une structure CONVCONTEXT qui contient des informations de contexte pour la conversation. Si le client n’est pas une application DDEML, ce paramètre est défini sur 0.
dwData2: Spécifie si le client est le même instance d’application que le serveur. Si le paramètre a la valeur 1, le client est le même instance. Si le paramètre est 0, le client est un autre instance.

Valeur retournée

Le serveur doit retourner un handle de données qui identifie un tableau de structures HSZPAIR . Le tableau doit contenir une structure pour chaque paire service-name et topic-name qui correspond à la paire service-name et topic-name demandée par le client. Le tableau doit être terminé par un handle de chaîne NULL . Le système envoie la transaction XTYP_CONNECT_CONFIRM au serveur pour confirmer chaque conversation et passer les handles de conversation au serveur. Le serveur ne recevra pas ces confirmations s’il a spécifié l’indicateur CBF_SKIP_CONNECT_CONFIRMS dans la fonction DdeInitialize .

Le serveur doit retourner NULL pour refuser la transaction XTYP_WILDCONNECT .

Notes

Cette transaction est filtrée si l’application serveur a spécifié l’indicateur CBF_FAIL_CONNECTIONS dans la fonction DdeInitialize .

Un serveur ne peut pas bloquer ce type de transaction ; le code de retour CBR_BLOCK est ignoré.

Spécifications

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

Voir aussi

Référence
CONVCONTEXT
DdeConnect
DdeInitialize
HSZPAIR
Conceptuel
Bibliothèque de gestion Dynamic Data Exchange

Share via