DdeConnectList 函式 (ddeml.h)

發行項
02/28/2024

建立與支援指定服務名稱和主題名稱組之所有伺服器應用程式的交談。應用程式也可以使用此函式，藉由傳遞函式現有的交談句柄來取得交談句柄清單。動態數據交換管理連結庫會從交談清單中移除任何終止交談的句柄。產生的交談清單包含所有目前建立之交談的句柄，這些交談支援指定的服務名稱和主題名稱。

語法

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

參數

[in] idInst

類型： DWORD

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

[in] hszService

類型： HSZ

字串的句柄，指定要建立交談的伺服器應用程式服務名稱。如果此參數為 0L，系統會嘗試建立與支援指定主題名稱之所有可用伺服器的對話。

[in] hszTopic

類型： HSZ

字串的句柄，指定要建立交談的主題名稱。此句柄必須由先前呼叫 DdeCreateStringHandle 函式所建立。如果此參數為 0L，系統會嘗試在所選伺服器所支援的所有主題上建立交談 (或伺服器) 。

[in] hConvList

類型： HCONVLIST

要列舉之交談清單的句柄。如果要建立新的交談清單，此參數應該是 0L。

[in, optional] pCC

類型： PCONVCONTEXT

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

傳回值

類型： HCONVLIST

如果函式成功，傳回值就是新交談清單的句柄。

如果函式失敗，則傳回值為 0L。舊交談清單的句柄已不再有效。

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

備註

應用程式必須釋放 DdeConnectList 函式傳回的交談清單句柄，不論清單中是否有任何交談句柄都作用中。若要釋放句柄，應用程式可以呼叫 DdeDisconnectList。

默認 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