NetMessageNameDel 函式 (lmmsg.h)

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

NetMessageNameDel函式會刪除訊息名稱資料表中的訊息別名。函式需要啟動 Messenger 服務。

語法

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

[in] servername

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

[in] msgname

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

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

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

傳回碼	描述
ERROR_ACCESS_DENIED	呼叫端沒有適當的存取權來完成作業。
ERROR_INVALID_PARAMETER	參數不正確。
ERROR_NOT_SUPPORTED	不支援此要求。此錯誤會在 Windows Vista 和更新版本上傳回。
NERR_DelComputerName	無法刪除也是電腦名稱稱的訊息別名。
NERR_IncompleteDel	訊息別名未從所有網路成功刪除。
NERR_NameInUse	訊息別名目前正在使用中。請稍後再試一次。
NERR_NotLocalName	訊息別名不在本機電腦上。

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