DdeConnect 函式 (ddeml.h)

發行項
02/26/2024

建立與支援指定服務名稱和主題名稱組的伺服器應用程式交談。如果有多個這類伺服器存在，系統只會選取一部伺服器。

語法

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

參數

[in] idInst

類型： DWORD

先前呼叫 DdeInitialize 函式所取得的應用程式實例識別碼。

[in] hszService

類型： HSZ

字串的句柄，指定要建立交談的伺服器應用程式服務名稱。此句柄必須由先前呼叫 DdeCreateStringHandle 函式所建立。如果此參數為 0L，則會與任何可用的伺服器建立交談。

[in] hszTopic

類型： HSZ

字串的句柄，指定要建立交談的主題名稱。此句柄必須由先前呼叫 DdeCreateStringHandle 所建立。如果此參數為 0L，就會建立所選伺服器所支援之任何主題上的交談。

[in, optional] pCC

類型： PCONVCONTEXT

包含交談內容資訊的 CONVCONTEXT 結構的指標。如果此參數為 NULL，伺服器會在XTYP_CONNECT或XTYP_WILDCONNECT交易期間收到預設的 CONVCONTEXT 結構。

傳回值

類型： HCONV

如果函式成功，則傳回值是已建立交談的句柄。

如果函式失敗，則傳回值為 0L。

DdeGetLastError 函式可用來取得錯誤碼，它可以是下列其中一個值：

備註

用戶端應用程式無法假設選取的伺服器。如果在 hszService 參數中指定實例特定名稱，則只會使用指定的實例來建立交談。實例特定的服務名稱會在 XTYP_REGISTER 和XTYP_UNREGISTER交易期間傳遞至應用程式的動態數據 Exchange (DDE ) 回呼函式。

默認 CONVCONTEXT 結構的所有成員都會設定為零，但 cb 會指定結構的大小， 而 iCodePage 會指定 CP_WINANSI ( 預設代碼頁) 或 CP_WINUNICODE，視用戶端應用程式呼叫 DdeInitialize 函式的 ANSI 或 Unicode 版本而定。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	ddeml.h (包含 Windows.h)
程式庫	User32.lib
Dll	User32.dll