NetMessageNameAdd 函式 (lmmsg.h)

[自 Windows Vista 起不支援此函式，因為不支援 Messenger 服務。]

NetMessageNameAdd 函式會在訊息名稱數據表中註冊訊息別名。函式需要啟動 Messenger 服務。

語法

NET_API_STATUS NET_API_FUNCTION NetMessageNameAdd(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname
);

[in] servername

常數位符串的指標，指定函式執行所在遠端伺服器的 DNS 或 NetBIOS 名稱。如果此參數為 NULL，則會使用本機電腦。

[in] msgname

常數位符串的指標，指定要加入的訊息別名。字串長度不能超過15個字元。

如果函式成功，傳回值會NERR_Success。

如果函式失敗，傳回值可以是下列其中一個錯誤碼。

傳回碼	Description
ERROR_ACCESS_DENIED	呼叫端沒有適當的存取權可完成作業。
ERROR_INVALID_PARAMETER	參數不正確。
ERROR_NOT_SUPPORTED	不支援此要求。此錯誤會在 Windows Vista 和更新版本上傳回。
NERR_AlreadyExists	此電腦上的訊息別名已經存在。如需詳細資訊，請參閱接下來的＜備註＞一節。
NERR_DuplicateName	指定的名稱已在網路上當做訊息別名使用。
NERR_NetworkError	網路硬體發生一般失敗。
NERR_TooManyNames	已超過訊息別名的數目上限。

只有 Administrators 本地組的成員可以在遠端伺服器上成功執行 NetMessageNameAdd 函式 。

轉寄動作旗標不再是 LAN Manager 2 的參數。xNetMessageNameAdd 函式，因為不再支援訊息轉送。如果 NetMessageNameAdd 函式偵測到網路上有轉送的 msgname 版本，函式將會失敗，並出現錯誤NERR_Already_Exists。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	lmmsg.h (包含 Lm.h)
程式庫	Netapi32.lib
Dll	Netapi32.dll