Fonction DdeConnectList (ddeml.h)

Article
03/04/2024

Établit une conversation avec toutes les applications serveur qui prennent en charge la paire nom de service et nom de rubrique spécifiée. Une application peut également utiliser cette fonction pour obtenir une liste de handles de conversation en passant à la fonction un handle de conversation existant. La bibliothèque de gestion Dynamic Data Exchange supprime les handles de toutes les conversations terminées de la liste des conversations. La liste de conversations qui en résulte contient les handles de toutes les conversations actuellement établies qui prennent en charge le nom de service et le nom de la rubrique spécifiés.

Syntaxe

HCONVLIST DdeConnectList(
  [in]           DWORD        idInst,
  [in]           HSZ          hszService,
  [in]           HSZ          hszTopic,
  [in]           HCONVLIST    hConvList,
  [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. Si ce paramètre a la valeur 0L, le système tente d’établir des conversations avec tous les serveurs disponibles qui prennent en charge le nom de rubrique spécifié.

[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 à la fonction DdeCreateStringHandle . Si ce paramètre a la valeur 0L, le système tente d’établir des conversations sur toutes les rubriques prises en charge par le ou les serveurs sélectionnés.

[in] hConvList

Type : HCONVLIST

Handle de la liste des conversations à énumérer. Ce paramètre doit être 0L si une nouvelle liste de conversations doit être é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 : HCONVLIST

Si la fonction réussit, la valeur de retour est le handle d’une nouvelle liste de conversations.

Si la fonction échoue, la valeur de retour est 0L. Le handle de l’ancienne liste de conversations n’est plus valide.

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

Remarques

Une application doit libérer le handle de liste de conversations retourné par la fonction DdeConnectList , que les handles de conversation de la liste soient actifs ou non. Pour libérer le handle, une application peut appeler DdeDisconnectList.

Tous les membres de la structure CONVCONTEXT par défaut sont définis sur zéro à l’exception de cb, spécifiant la taille de la structure et iCodePage, spécifiant CP_WINANSI (page de codes 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