Partager via


transaction XTYP_CONNECT

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