共用方式為


DdeNameService 函式 (ddeml.h)

註冊或取消註冊服務名稱動態資料 Exchange (DDE) 伺服器支援。 此函式會讓系統將 XTYP_REGISTERXTYP_UNREGISTER 交易傳送至其他執行 中的動態 Data Exchange 管理程式庫 , (DDEML) 用戶端應用程式。

語法

HDDEDATA DdeNameService(
  [in]           DWORD idInst,
  [in, optional] HSZ   hsz1,
  [in, optional] HSZ   hsz2,
  [in]           UINT  afCmd
);

參數

[in] idInst

類型: DWORD

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

[in, optional] hsz1

類型: HSZ

字串的控制碼,指定伺服器正在註冊或取消註冊的服務名稱。 取消註冊其所有服務名稱的應用程式應該將此參數設定為 0L。

[in, optional] hsz2

類型: HSZ

保留;應該設定為 0L。

[in] afCmd

類型: UINT

服務名稱選項。 此參數可以是下列其中一個值。

意義
DNS_REGISTER
0x0001
註冊錯誤碼服務名稱。
DNS_UNREGISTER
0x0002
取消註冊錯誤碼服務名稱。 如果 hsz1 參數為 0L,則伺服器註冊的所有服務名稱都會取消註冊。
DNS_FILTERON
0x0004
開啟服務名稱初始篩選。 篩選可防止伺服器接收尚未註冊的服務名稱 XTYP_CONNECT 交易。 這是此篩選的預設設定。

如果伺服器應用程式未註冊任何服務名稱,則應用程式無法接收 XTYP_WILDCONNECT 交易。

DNS_FILTEROFF
0x0008
關閉服務名稱初始篩選。 如果指定此旗標,每當另一個DDE 應用程式呼叫 DdeConnect函式,不論服務名稱為何,伺服器都會收到XTYP_CONNECT交易。

傳回值

類型: HDDEDATA

如果函式成功,它會傳回非零值。 該值不是真正的 HDDEDATA 值,只是成功的布林值指標。 函式是類型 HDDEDATA ,可允許未來擴充函式和更複雜的傳回值。

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

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

備註

hsz1參數所識別的服務名稱應該是基底名稱 (,也就是說,名稱應該不包含任何實例特定資訊) 。 系統會產生實例特定名稱,並在 XTYP_REGISTERXTYP_UNREGISTER 交易期間連同基底名稱一起傳送。 接收的應用程式接著可以連線到特定的應用程式實例。

需求

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

另請參閱

概念

DdeConnect

DdeConnectList

DdeInitialize

動態資料交換管理程式庫

參考

XTYP_REGISTER

XTYP_UNREGISTER