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。
如果函式失敗,傳回值可以是下列其中一個錯誤碼。
傳回碼 | 描述 |
---|---|
|
呼叫端沒有適當的存取權來完成作業。 |
|
參數不正確。 |
|
不支援此要求。 此錯誤會在 Windows Vista 和更新版本上傳回。 |
|
找不到使用者名稱。 |
|
網路硬體發生一般失敗。 |
備註
如果您在執行 Active Directory 的網域控制站上呼叫此函式,則會根據安全性實體物件的存取控制清單 (ACL) ,允許或拒絕存取。 預設 ACL 只允許網域管理員和帳戶操作員呼叫此函式。 在成員伺服器或工作站上,只有系統管理員和伺服器操作員可以呼叫此函式。 如需詳細資訊,請參閱 網路管理功能的安全性需求。 如需 ACL 和 ACE 的詳細資訊,請參閱存取控制模型。
需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | lmmsg.h (包括 Lm.h) |
程式庫 | Netapi32.lib |
Dll | Netapi32.dll |