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