Fonction DdeConnect (ddeml.h)

Article
02/27/2024

É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