Uc pm send

出自Discuz! 技术文库

跳转到: 导航, 搜索

uc_pm_send

integer uc_pm_send(integer fromuid , string msgto , string subject , string message [, bool instantly , integer replypmid , bool isusername , integer type])

目录

描述

本接口函数用于发送短消息。当 instantly 为 1 时,短消息会直接发送出去,否则本函数会发送一个 header 的 location 请求,使当前页面跳转到短消息中心的发送短消息页面。因此,当 instantly 为 0 时请不要在这个函数运行前后有任何的输出性的代码。type 为 1 时为发送群聊消息。msgto 默认为用户 ID,如果要让用户名作为参数,可让 isusername 为 1。replypid 为 0 表示发送的短消息为短消息话题的发起者,如果 replypid 为指定的消息 ID 则表示发送的短消息为回复指定短消息话题的回复信息。如果 instantly 为 1,那么发送成功后函数返回发送成功的最后一条消息 ID,返回 0 表示发送失败。

参数

参数名 类型 是否必需 说明 备注
fromuid integer 发件人用户 ID
msgto string 收件人用户名 / 用户 ID,多个用逗号分割
subject string 消息标题
message string 消息内容
instantly bool 是否直接发送 1:(默认值) 直接发送消息
0:进入发送短消息的界面
replypid integer 回复的消息 ID 大于 0:回复指定的短消息
0:(默认值) 发送新的短消息
isusername bool msgto 参数是否为用户名 1:msgto 参数为用户名
0:(默认值) msgto 参数为用户 ID
type integer 消息类别 1:群聊消息
0:(默认值)私人消息


范例

if(uc_pm_send($uid, $_POST['msgto'], $_POST['subject'], $_POST['message'])) {
	echo "短消息发送成功";
}


返回值

返回值类型 说明 备注
integer 大于 0:发送成功的最后一条消息 ID
0:发送失败
-1:超过两人会话的最大上限
-2:超过两次发送短消息时间间隔
-3:不能给非好友批量发送短消息(已废弃)
-4:目前还不能使用发送短消息功能(注册多少日后才可以使用发短消息限制)
-5:超过群聊会话的最大上限
-6:在忽略列表中
-7:超过群聊人数上限
-8:不能给自己发短消息
-9:收件人为空
-10:发起群聊人数小于两人
个人工具