Partager via


Fonction DdeConnect (ddeml.h)

Établit une conversation avec une application serveur qui prend en charge le nom de service et la paire de noms de rubrique spécifiés. S’il existe plusieurs serveurs de ce type, le système n’en sélectionne qu’un seul.

Syntaxe

HCONV DdeConnect(
  [in]           DWORD        idInst,
  [in]           HSZ          hszService,
  [in]           HSZ          hszTopic,
  [in, optional] PCONVCONTEXT pCC
);

Paramètres

[in] idInst

Type : DWORD

L’application instance identificateur obtenu par un appel précédent à la fonction DdeInitialize.

[in] hszService

Type : HSZ

Handle de la chaîne qui spécifie le nom de service de l’application serveur avec laquelle une conversation doit être établie. Ce handle doit avoir été créé par un appel précédent à la fonction DdeCreateStringHandle . Si ce paramètre est 0L, une conversation est établie avec n’importe quel serveur disponible.

[in] hszTopic

Type : HSZ

Handle de la chaîne qui spécifie le nom de la rubrique sur laquelle une conversation doit être établie. Ce handle doit avoir été créé par un appel précédent à DdeCreateStringHandle. Si ce paramètre est 0L, une conversation sur une rubrique prise en charge par le serveur sélectionné est établie.

[in, optional] pCC

Type : PCONVCONTEXT

Pointeur vers la structure CONVCONTEXT qui contient des informations de contexte de conversation. Si ce paramètre a la valeur NULL, le serveur reçoit la structure CONVCONTEXT par défaut pendant la transaction XTYP_CONNECT ou XTYP_WILDCONNECT .

Valeur retournée

Type : HCONV

Si la fonction réussit, la valeur de retour est le handle de la conversation établie.

Si la fonction échoue, la valeur de retour est 0L.

La fonction DdeGetLastError peut être utilisée pour obtenir le code d’erreur, qui peut être l’une des valeurs suivantes :

Remarques

L’application cliente ne peut pas faire d’hypothèses concernant le serveur sélectionné. Si un nom spécifique à instance est spécifié dans le paramètre hszService, une conversation est établie avec uniquement le instance spécifié. Les noms de service spécifiques à l’instance sont passés à la fonction de rappel DDE (Dynamic Data Exchange) d’une application pendant les transactions XTYP_REGISTER et XTYP_UNREGISTER .

Tous les membres de la structure CONVCONTEXT par défaut sont définis sur zéro, à l’exception de cb, qui spécifie la taille de la structure, et iCodePage, qui spécifie CP_WINANSI (la page de code par défaut) ou CP_WINUNICODE, selon que la version ANSI ou Unicode de la fonction DdeInitialize a été appelée par l’application cliente.

Configuration requise

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]
Plateforme cible Windows
En-tête ddeml.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll

Voir aussi

CONVCONTEXT

Conceptuel

DdeConnectList

DdeCreateStringHandle

DdeDisconnect

DdeDisconnectList

DdeInitialize

Bibliothèque de gestion d’Échange de données dynamiques

Référence

XTYP_REGISTER

XTYP_UNREGISTER