DdeConnect-Funktion (ddeml.h)

Artikel
03/01/2024

Richtet eine Konversation mit einer Serveranwendung ein, die das angegebene Dienstnamen- und Themennamenpaar unterstützt. Wenn mehrere solcher Server vorhanden sind, wählt das System nur einen aus.

Syntax

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

Parameter

[in] idInst

Art: DWORD

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

[in] hszService

Typ: HSZ

Ein Handle für die Zeichenfolge, das den Dienstnamen der Serveranwendung angibt, mit der eine Konversation eingerichtet werden soll. Dieses Handle muss durch einen vorherigen Aufruf der DdeCreateStringHandle-Funktion erstellt worden sein. Wenn dieser Parameter 0L ist, wird eine Konversation mit einem beliebigen verfügbaren Server eingerichtet.

[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 von DdeCreateStringHandle erstellt worden sein. Wenn dieser Parameter 0L ist, wird eine Konversation zu einem beliebigen Thema eingerichtet, das vom ausgewählten Server unterstützt wird.

[in, optional] pCC

Typ: PCONVCONTEXT

Ein Zeiger auf die CONVCONTEXT-Struktur , die Informationen zum Unterhaltungskontext enthält. Wenn dieser Parameter NULL ist, empfängt der Server die CONVCONTEXT-Standardstruktur während der XTYP_CONNECT - oder XTYP_WILDCONNECT-Transaktion .

Rückgabewert

Typ: HCONV

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Handle für die etablierte Konversation.

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0L.

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

Hinweise

Die Clientanwendung kann keine Annahmen bezüglich des ausgewählten Servers treffen. Wenn im hszService-Parameter ein instance spezifischer Name angegeben wird, wird eine Konversation nur mit dem angegebenen instance eingerichtet. Instanzspezifische Dienstnamen werden während der XTYP_REGISTER und XTYP_UNREGISTER Transaktionen an die DDE-Rückruffunktion (Dynamic Data Exchange) einer Anwendung übergeben.

Alle Member der CONVCONTEXT-Standardstruktur sind auf null festgelegt, mit Ausnahme von cb, das die Größe der Struktur angibt, und iCodePage, die CP_WINANSI (die Standardcodepage) oder CP_WINUNICODE angibt, 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 (Einschließen von Windows.h)
Bibliothek	User32.lib
DLL	User32.dll