更新时间:2023-10-23 GMT+08:00
PQcancel
功能描述
要求服务器放弃处理当前命令。
原型
int PQcancel(PGcancel *cancel, char *errbuf, int errbufsize);
参数
关键字 |
参数说明 |
---|---|
cancel |
指向包含cancel信息的对象指针。 |
errbuf |
出错保存错误信息的buffer。 |
errbufsize |
保存错误信息的buffer大小。 |
返回值
int:执行结果为1表示成功,0表示失败,失败原因存到errbuf中。
注意事项
- 成功发送并不保证请求将产生任何效果。如果取消有效,当前命令将提前终止并返回错误结果。如果取消失败(例如,因为服务器已经处理完命令),无返回结果。
- 如果errbuf是信号处理程序中的局部变量,则可以安全地从信号处理程序中调用PQcancel。就PQcancel而言,PGcancel对象是只读的,因此它也可以从一个线程中调用,这个线程与操作PGconn对象线程是分离的。
示例
请参见示例章节。
父主题: 取消正在处理的查询