DdeConnectList-Funktion (ddeml.h)

Artikel
03/01/2024

Erstellt eine Konversation mit allen Serveranwendungen, die das angegebene Dienstnamen- und Themennamenpaar unterstützen. Eine Anwendung kann diese Funktion auch verwenden, um eine Liste von Konversationshandles abzurufen, indem sie der Funktion ein vorhandenes Konversationshandle übergibt. Die Dynamic Data Exchange-Verwaltungsbibliothek entfernt die Handles aller beendeten Unterhaltungen aus der Unterhaltungsliste. Die resultierende Unterhaltungsliste enthält die Handles aller derzeit eingerichteten Unterhaltungen, die den angegebenen Dienstnamen und Den angegebenen Themennamen unterstützen.

Syntax

HCONVLIST DdeConnectList(
  [in]           DWORD        idInst,
  [in]           HSZ          hszService,
  [in]           HSZ          hszTopic,
  [in]           HCONVLIST    hConvList,
  [in, optional] PCONVCONTEXT pCC
);

Parameter

[in] idInst

Art: DWORD

Die Anwendung instance Bezeichner, der durch einen vorherigen Aufruf der Funktion DdeInitialize abgerufen wurde.

[in] hszService

Typ: HSZ

Ein Handle für die Zeichenfolge, das den Dienstnamen der Serveranwendung angibt, mit der eine Konversation hergestellt werden soll. Wenn dieser Parameter 0L ist, versucht das System, Unterhaltungen mit allen verfügbaren Servern herzustellen, die den angegebenen Themennamen unterstützen.

[in] hszTopic

Typ: HSZ

Ein Handle für die Zeichenfolge, das den Namen des Themas angibt, für das eine Konversation eingerichtet werden soll. Dieses Handle muss durch einen vorherigen Aufruf der Funktion DdeCreateStringHandle erstellt worden sein. Wenn dieser Parameter 0L ist, versucht das System, Unterhaltungen zu allen Themen zu erstellen, die vom ausgewählten Server (oder Servern) unterstützt werden.

[in] hConvList

Typ: HCONVLIST

Ein Handle für die aufzuzählende Unterhaltungsliste. Dieser Parameter sollte 0L sein, wenn eine neue Unterhaltungsliste erstellt werden soll.

[in, optional] pCC

Typ: PCONVCONTEXT

Ein Zeiger auf die CONVCONTEXT-Struktur , die Konversationskontextinformationen enthält. Wenn dieser Parameter NULL ist, empfängt der Server während der XTYP_CONNECT- oder XTYP_WILDCONNECT-Transaktion die standardmäßige CONVCONTEXT-Struktur.

Rückgabewert

Typ: HCONVLIST

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Handle für eine neue Unterhaltungsliste.

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0L. Das Handle für die alte Unterhaltungsliste ist nicht mehr gültig.

Die DdeGetLastError-Funktion kann verwendet werden, um den Fehlercode abzurufen, der einer der folgenden Werte sein kann:

Hinweise

Eine Anwendung muss das von der DdeConnectList-Funktion zurückgegebene Konversationslistenhandle freigeben, unabhängig davon, ob Konversationshandles innerhalb der Liste aktiv sind. Um das Handle frei zu geben, kann eine Anwendung DdeDisconnectList aufrufen.

Alle Member der CONVCONTEXT-Standardstruktur werden auf null festgelegt, mit Ausnahme von cb, wobei die Größe der Struktur angegeben wird, und iCodePage, wobei CP_WINANSI (die Standardcodepage) oder CP_WINUNICODE angegeben wird, je nachdem, ob die ANSI- oder Unicode-Version der DdeInitialize-Funktion von der Clientanwendung aufgerufen wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ddeml.h (Windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll