XTYP_WILDCONNECT transaction
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 |
|
Voir aussi
-
Référence
-
Conceptuel