Tạo cấu trúc dữ liệu chứa thông tin cần thiết để hủy lệnh được phát kèo bóng đá pháp thông qua kết nối cơ sở dữ liệu cụ thể.

PQGetCancelTạo APGCANCELĐối tượng đã cho APGConnĐối tượng kết nối. Nó sẽ trở lạinullNếu đã choConnlànullhoặc kết nối không hợp lệ. ThePGCANCELĐối tượng là cấu trúc mờ không có nghĩa là được kèo bóng đá pháp cập trực tiếp bởi ứng dụng; nó chỉ có thể được kèo bóng đá phápền choPQCANCELhoặcPQFreeCANCEL.

giải phóng cấu trúc dữ liệu được tạo bởiPQGetCancel.

VOID PQFREECANCEL (PGCANCEL *Hủy);

PQFreeCANCELgiải phóng một đối tượng dữ liệu được tạo trước đó bởiPQGetCancel.

Yêu cầu máy chủ từ bỏ xử lý lệnh hiện tại.

12914_12979

Giá trị trả về là 1 nếu yêu cầu hủy được gửi thành công và 0 nếu không. Nếu không,errbufđược điền vào thông báo lỗi giải thích.errbufPhải là một mảng char có kích thướcerrbufsize(kích thước được đề xuất là 256 byte).

Công văn thành công không đảm bảo rằng yêu cầu sẽ có bất kỳ ảnh hưởng nào. Nếu hủy bỏ có hiệu lực, lệnh hiện tại sẽ chấm dứt sớm và trả về kết quả lỗi.

PQCANCELcó thể được gọi một cách an toàn từ trình xử lý tín hiệu, nếuerrbuflà một biến cục bộ trong trình xử lý tín hiệu. ThePGCANCELĐối tượng chỉ đọc xa nhưPQCANCELcó liên quan, vì vậy nó cũng có thể được gọi từ một chủ đề tách biệt với một người thao túngPGConnĐối tượng.

PQRequestCancellà biến thể không dùng củaPQCANCEL.

int pqrequestCancel (pgconn *Conn);

yêu cầu máy chủ từ bỏ xử lý lệnh hiện tại. Nó hoạt động trực tiếp trênPGConnĐối tượng và trong trường hợp lỗi lưu trữ thông báo lỗi trongPGConnĐối tượng (từ đó có thể được kèo bóng đá pháp xuất bởipqerrormessage). Mặc dù chức năng là như nhau, cách tiếp cận này tạo ra các mối nguy hiểm cho các chương trình nhiều luồng và trình xử lý tín hiệu, vì có thể ghi đè lênPGConncủa thông báo lỗi sẽ làm rối tung hoạt động hiện đang được tiến kèo bóng đá pháp trên kết nối.