Uc pm send

'''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 表示发送失败。

==参数==

{| style="background-color:#dfb; border-collapse: collapse; border-spacing: 3px; border:1px solid #8d0; margin: 0px; width: 100%" cellpadding="5"
|-
| '''参数名'''
| '''类型'''
| '''是否必需'''
| '''说明'''
| '''备注'''
|-
| fromuid
| integer
| 是
| 发件人用户 ID
|
|-
| msgto
| string
| 是
| 收件人用户名 / 用户 ID，多个用逗号分割
|
|-
| subject
| string
| 是
| 消息标题
|
|-
| message
| string
| 是
| 消息内容
|
|-
| instantly
| bool
| 否
| 是否直接发送
| 1:(默认值) 直接发送消息<br>0:进入发送短消息的界面
|-
| replypid
| integer
| 否
| 回复的消息 ID
| 大于 0:回复指定的短消息<br>0:(默认值) 发送新的短消息
|-
| isusername
| bool
| 否
| msgto 参数是否为用户名
| 1:msgto 参数为用户名<br>0:(默认值) msgto 参数为用户 ID
|-
| type
| integer
| 否
| 消息类别
| 1:群聊消息<br>0:(默认值)私人消息
|}


==范例==

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


==返回值==

{|style="background-color:#feb; border-collapse: collapse; border-spacing: 3px; border:1px solid #fd8; margin: 0px; width: 100%" cellpadding="3"
|-
| '''返回值类型'''
| '''说明'''
| '''备注'''
|-
| integer
| 大于 0:发送成功的最后一条消息 ID<br>0:发送失败<br>-1:超过两人会话的最大上限<br>-2:超过两次发送短消息时间间隔<br>-3:不能给非好友批量发送短消息(已废弃)<br>-4:目前还不能使用发送短消息功能（注册多少日后才可以使用发短消息限制）<br>-5:超过群聊会话的最大上限<br>-6:在忽略列表中<br>-7:超过群聊人数上限<br>-8:不能给自己发短消息<br>-9:收件人为空<br>-10:发起群聊人数小于两人
|
|}