NetMessageBufferSend 函式 (lmmsg.h)

發行項
08/24/2023

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

NetMessageBufferSend函式會將資訊緩衝區傳送至已註冊的訊息別名。

語法

NET_API_STATUS NET_API_FUNCTION NetMessageBufferSend(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname,
  [in] LPCWSTR fromname,
  [in] LPBYTE  buf,
  [in] DWORD   buflen
);

參數

[in] servername

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

[in] msgname

常數位符串的指標，指定訊息緩衝區應該傳送至其中的訊息別名。

[in] fromname

指定訊息來源的常數位符串指標。如果此參數為 Null，訊息會從本機電腦名稱稱傳送。

[in] buf

包含郵件內文的緩衝區指標。如需詳細資訊，請參閱網路管理功能緩衝區。

[in] buflen

指定值，其中包含 buf 參數所指向之訊息文字的長度，以位元組為單位。

傳回值

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

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

傳回碼	描述
ERROR_ACCESS_DENIED	呼叫端沒有適當的存取權來完成作業。
ERROR_INVALID_PARAMETER	參數不正確。
ERROR_NOT_SUPPORTED	不支援此要求。此錯誤會在 Windows Vista 和更新版本上傳回。
NERR_NameNotFound	找不到使用者名稱。
NERR_NetworkError	網路硬體發生一般失敗。

備註

如果您在執行 Active Directory 的網域控制站上呼叫此函式，則會根據安全性實體物件的存取控制清單 (ACL) ，允許或拒絕存取。預設 ACL 只允許網域管理員和帳戶操作員呼叫此函式。在成員伺服器或工作站上，只有系統管理員和伺服器操作員可以呼叫此函式。如需詳細資訊，請參閱網路管理功能的安全性需求。如需 ACL 和 ACE 的詳細資訊，請參閱存取控制模型。

需求


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