PQputCopyEnd

功能描述

在COPY_IN状态里向服务器发送数据完毕的指示。

int PQputCopyEnd(PGconn *conn,    
                 const char *errormsg);

参数	描述
conn	建立连接时返回的连接结构体指针，该指针用于标识某个特定连接。
errormsg	如果errormsg是NULL，则成功结束COPY_IN操作。如果errormsg不是NULL则COPY操作被强制失败， errormsg指向的字串是错误消息。（我们不能认为同样的错误消息可能会从服务器传回，因为服务器可能已经因为自己的原因让COPY失败。还要注意的是在使用 3.0 版本之前的协议连接时，强制失败的选项是不能用的。）

如果终止数据发送，则结果为 1，如果发送企图会阻塞（只有在连接是在非阻塞模式的情况下才可能出现这个情况），则为零，如果发生错误则返回 -1。（如果返回值是 -1，用PQerrorMessage 检索细节。如果值是零，那么等待写准备好然后重新尝试）

在成功调用PQputCopyEnd之后，调用PQgetResult获取COPY 命令的最终结果状态。我们可以用平常的方法来等待这个结果可用。然后返回到正常的操作。