Sự kèo bóng đá pháp đăng ký xảy ra khiPQRegisterEventProcđược gọi. Đó là thời điểm lý tưởng để khởi tạo bất kỳInstancedataMột thủ tục sự kèo bóng đá pháp có thể cần. Chỉ có một sự kèo bóng đá pháp đăng ký sẽ được sa thải trên mỗi người xử lý sự kèo bóng đá pháp cho mỗi kết nối.

Cấu trúc typedef

Khi APGEVT_REGISTERSự kèo bóng đá pháp được nhận,evtinfoCon trỏ nên được đúc đến APGEVENTREGISTER *. Cấu trúc này chứaPGConnnên có trongConnection_oktrạng thái; Đảm bảo nếu một người gọipqregistereventProcNgay sau khi có được một điều tốtPGConn. Khi trả lại mã thất bại, tất cả các công việc dọn dẹp phải được thực hiện dưới dạng kèo bóng đá phápPGEVT_ConnDestroySự kèo bóng đá pháp sẽ được gửi.

Sự kèo bóng đá pháp đặt lại kết nối được bắn khi hoàn thànhpqresethoặcpqresetpoll. Trong cả hai trường hợp, sự kèo bóng đá pháp chỉ được bắn nếu thiết lập lại thành công.PostgreSQLV15 trở lên. Tuy nhiên, với các phiên bản trước đó, điều quan trọng là phải trả lại thành công (khác kèo bóng đá pháp) hoặc kết nối sẽ bị hủy bỏ.

Cấu trúc typedef

Khi APGEVT_CONNRESETSự kèo bóng đá pháp được nhận,EVTINFOCon trỏ nên được đúc đến APGEVENTCONNRESET *. Mặc dù được chứaPGConnchỉ được đặt lại, tất cả dữ liệu sự kèo bóng đá pháp vẫn không thay đổi. Sự kèo bóng đá pháp này nên được sử dụng để đặt lại/tải lại/yêu cầu bất kỳ liên quan nàoInstancedata. Lưu ý rằng ngay cả khi quy trình sự kèo bóng đá pháp không xử lýPGEVT_CONNRESET, nó vẫn sẽ nhận đượcPGEVT_ConnDestroySự kèo bóng đá pháp khi kết nối được đóng.

Sự kèo bóng đá pháp phá hủy kết nối được bắn để phản hồipqfinish. Trách nhiệm của thủ tục sự kèo bóng đá pháp là làm sạch dữ liệu sự kèo bóng đá pháp của mình vì LibPQ không có khả năng quản lý bộ nhớ này.

Cấu trúc typedef

Khi APGEVT_ConnDestroySự kèo bóng đá pháp được nhận,EVTINFOCon trỏ nên được đúc đến ApgEventConnDestroy *. Sự kèo bóng đá pháp này được bắn trướcpqfinishThực hiện bất kỳ việc dọn dẹp nào khác. Giá trị trả về của thủ tục sự kèo bóng đá pháp bị bỏ qua vì không có cách nào chỉ ra sự thất bại từpqfinish. Ngoài ra, một lỗi thủ tục sự kèo bóng đá pháp không nên hủy bỏ quá trình làm sạch bộ nhớ không mong muốn.

Sự kèo bóng đá pháp tạo kết quả được bắn để đáp ứng với bất kỳ chức năng thực thi truy vấn nào tạo ra kết quả, bao gồmPQGetResult. Sự kèo bóng đá pháp này sẽ chỉ được bắn sau khi kết quả đã được tạo thành công.

Cấu trúc typedef

Khi APGEVT_RESULTCREATESự kèo bóng đá pháp được nhận,evtinfoCon trỏ nên được chuyển đến APGEVENTRESULTCREATE *. TheConnlà kết nối được sử dụng để tạo kết quả. Đây là nơi lý tưởng để khởi tạo bất kỳInstancedatacần được liên kết với kết quả. Nếu một thủ tục sự kèo bóng đá pháp không thành công (trả về số 0), quy trình sự kèo bóng đá pháp đó sẽ bị bỏ qua trong thời gian tồn tại còn lại của kết quả;PGEVT_RESULTCOPYhoặcPGEVT_RESULTDESTROYSự kèo bóng đá pháp cho kết quả hoặc kết quả này được sao chép từ nó.

Sự kèo bóng đá pháp bản sao kết quả được bắn để phản hồiPQCopyresult. Sự kèo bóng đá pháp này sẽ chỉ được bắn sau khi bản sao hoàn tất.PGEVT_RESULTCREATEhoặcPGEVT_RESULTCOPYSự kèo bóng đá pháp cho kết quả nguồn sẽ nhận đượcPGEVT_RESULTCOPYSự kèo bóng đá pháp.

Cấu trúc typedef

Khi APGEVT_RESULTCOPYSự kèo bóng đá pháp được nhận,evtinfoCon trỏ nên được đúc đến APGEVENTRESULTCOPY *. TheSRCKết quả là những gì đã được sao chép trong khiDestKết quả là điểm đến sao chép. Sự kèo bóng đá pháp này có thể được sử dụng để cung cấp một bản sao sâu củaInstancedata, kể từPQCopyresultKhông thể làm điều đó. Nếu một thủ tục sự kèo bóng đá pháp không thành công (trả về số 0), quy trình sự kèo bóng đá pháp đó sẽ bị bỏ qua trong thời gian tồn tại còn lại của kết quả mới;PGEVT_RESULTCOPYhoặcPGEVT_RESULTDESTROYSự kèo bóng đá pháp cho kết quả đó hoặc kết quả được sao chép từ nó.

Sự kèo bóng đá pháp phá hủy kết quả được bắn để đáp ứng vớiPQClear. Trách nhiệm của thủ tục sự kèo bóng đá pháp là làm sạch dữ liệu sự kèo bóng đá pháp của mình vì LibPQ không có khả năng quản lý bộ nhớ này.

Cấu trúc typedef

Khi APGEVT_RESULTDESTROYSự kèo bóng đá pháp được nhận,evtinfoCon trỏ nên được đúc đến APGEVENTRESULTDESTROY *. Sự kèo bóng đá pháp này được bắn trướcPQClearThực hiện bất kỳ việc dọn dẹp nào khác. Giá trị trả về của thủ tục sự kèo bóng đá pháp bị bỏ qua vì không có cách nào chỉ ra sự thất bại từPQClear. Ngoài ra, một lỗi thủ tục sự kèo bóng đá pháp không nên hủy bỏ quá trình làm sạch bộ nhớ không mong muốn.

PGEVENTPROClà một typedef cho một con trỏ đến quy trình sự kèo bóng đá pháp, nghĩa là chức năng gọi lại của người dùng nhận các sự kèo bóng đá pháp từ libpq. Chữ ký của thủ tục sự kèo bóng đá pháp phải là

22394_22462

TheEVTIDTham số cho biếtPGEVTSự kèo bóng đá pháp đã xảy ra. TheevtinfoCon trỏ phải được chuyển vào loại cấu trúc thích hợp để có thêm thông tin về sự kèo bóng đá pháp này. TheVượt quatham số là con trỏ được cung cấp choPQRegisterEventProcKhi thủ tục sự kèo bóng đá pháp được đăng ký. Hàm sẽ trả về một giá trị khác không nếu nó thành công và không nếu nó thất bại.

Một quy trình sự kèo bóng đá pháp cụ thể chỉ có thể được đăng ký một lần trong bất kỳPGConn. Điều này là do địa chỉ của thủ tục được sử dụng làm khóa tra cứu để xác định dữ liệu thể hiện được liên kết.

Đăng ký quy trình gọi lại sự kèo bóng đá pháp với libpq.

int pqregistereventProc (PGConn *Conn, PGEVEN

Một quy trình sự kèo bóng đá pháp phải được đăng ký một lần trên mỗiPGConnBạn muốn nhận các sự kèo bóng đá pháp về. Không có giới hạn, ngoài bộ nhớ, về số lượng các quy trình sự kèo bóng đá pháp có thể được đăng ký với kết nối.

TheProcĐối số sẽ được gọi khi một sự kèo bóng đá pháp libpq được bắn. Địa chỉ bộ nhớ của nó cũng được sử dụng để tra cứuInstancedata. ThetênĐối số được sử dụng để chỉ quy trình sự kèo bóng đá pháp trong các thông báo lỗi. Giá trị này không thể lànullhoặc chuỗi kèo bóng đá pháp độ dài. Chuỗi tên được sao chép vàoPGConn, Vì vậy, những gì được thông qua kèo bóng đá pháp cần phải tồn tại lâu dài. TheVượt quaCon trỏ được chuyển choProcBất cứ khi nào một sự kèo bóng đá pháp xảy ra. Đối số này có thể lànull.

Đặt kết nốiConn'sInstancedatacho thủ tụcProcđếnData. Điều này trả về kèo bóng đá pháp phải cho thành công và kèo bóng đá pháp cho thất bại.Procchưa được đăng ký đúng trongConn.)

26686_26756

Trả về kết nốiConn'sInstancedatađược liên kết với thủ tụcProchoặcnullNếu kèo bóng đá pháp có.

void *pqinstancedata (const pgconn *Conn, pgEventProc Proc);

Đặt kết quảInstancedatachoProcđếnData. Điều này trả về kèo bóng đá pháp phải cho thành công và kèo bóng đá pháp cho thất bại.Procchưa được đăng ký đúng trong kết quả.)

28081_28158

Hãy cẩn thận rằng bất kỳ lưu trữ nào được đại diện bởiDatasẽ kèo bóng đá pháp được tính bởiPQResultMemorySize, trừ khi nó được phân bổ bằng cách sử dụngPQResultalloc. (Làm như vậy được khuyến nghị vì nó loại bỏ sự cần thiết phải giải phóng lưu trữ như vậy một cách rõ ràng khi kết quả bị phá hủy.)

Trả về kết quảInstancedatađược liên kết vớiProchoặcnullNếu kèo bóng đá pháp có.

29191_29261