共用方式為


NetMessageBufferSend 函式 (lmmsg.h)

[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

另請參閱

訊息函數

NetMessageNameAdd

NetMessageNameDel

NetMessageNameEnum

NetMessageNameGetInfo

網路管理功能

網路管理概觀