transaction XTYP_CONNECT

Article
06/12/2023

Un client utilise la transaction XTYP_CONNECT pour établir une conversation. Une fonction de rappel de serveur Dynamic Data Exchange (DDE), DdeCallback, reçoit cette transaction lorsqu’un client spécifie un nom de service que le serveur prend en charge (et un nom de rubrique qui n’est pas NULL) dans un appel à la fonction DdeConnect .

#define     XCLASS_BOOL              0x1000
#define     XTYPF_NOBLOCK            0x0002
#define     XTYP_CONNECT            (0x0060 | XCLASS_BOOL | XTYPF_NOBLOCK)

Paramètres

uType: Type de transaction.
uFmt: Non utilisé.
hconv: Non utilisé.
hsz1: Handle du nom de la rubrique.
hsz2: Handle du nom du service.
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 0.
dwData2: Spécifie si le client est la même application instance que le serveur. Si le paramètre est 1, le client est le même instance. Si le paramètre est 0, le client est un autre instance.

Valeur retournée

Une fonction de rappel de serveur doit retourner TRUE pour permettre au client d’établir une conversation sur le nom de service et la paire de noms de rubrique spécifiés, ou la fonction doit retourner FALSE pour refuser la conversation. Si la fonction de rappel retourne TRUE et qu’une conversation est correctement établie, le système transmet le handle de conversation au serveur en émettant une transaction XTYP_CONNECT_CONFIRM à la fonction de rappel du serveur (sauf si le serveur a spécifié l’indicateur CBF_SKIP_CONNECT_CONFIRMS dans la fonction DdeInitialize ).

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
Conceptuel
Bibliothèque de gestion d’Échange de données dynamiques

Partager via