DdeNameService 函式 (ddeml.h)

註冊或取消註冊服務名稱動態資料 Exchange (DDE) 伺服器支援。此函式會讓系統將 XTYP_REGISTER 或 XTYP_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_REGISTER 和 XTYP_UNREGISTER 交易期間連同基底名稱一起傳送。接收的應用程式接著可以連線到特定的應用程式實例。