共用方式為


DdeConnect 函式 (ddeml.h)

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

語法

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_CONNECTXTYP_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

另請參閱

CONVCONTEXT

概念

DdeConnectList

DdeCreateStringHandle

DdeDisconnect

DdeDisconnectList

DdeInitialize

動態數據交換管理連結庫

參考

XTYP_REGISTER

XTYP_UNREGISTER