Sự kèo bóng đá euro đă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 quy trình sự kèo bóng đá euro có thể cần. Chỉ có một sự kèo bóng đá euro đăng ký sẽ được sa thải trên mỗi người xử lý sự kèo bóng đá euro cho mỗi kết nối.

Cấu trúc typedef

Khi APGEVT_REGISTERSự kèo bóng đá euro đượ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 khôngPGEVT_ConnDestroySự kèo bóng đá euro sẽ được gửi.

Sự kèo bóng đá euro đặ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 đá euro 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 không) hoặc kèo bóng đá euro nối sẽ bị hủy bỏ.

Cấu trúc typedef

Khi APGEVT_CONNRESETSự kèo bóng đá euro được nhận,evtinfoCon trỏ nên được đúc đếnPGEVENTCONNRESET *. Mặc dù được chứaPGConnchỉ được đặt lại, tất cả dữ liệu sự kèo bóng đá euro vẫn không thay đổi. Sự kèo bóng đá euro 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 đá euro không xử lýPGEVT_CONNRESET, nó vẫn sẽ nhận đượcPGEVT_ConnDestroySự kèo bóng đá euro khi kết nối được đóng.

Sự kèo bóng đá euro 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 đá euro là làm sạch dữ liệu sự kèo bóng đá euro 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 đá euro được nhận,evtinfoCon trỏ nên được đúc đến ApgEventConnDestroy *. Sự kèo bóng đá euro 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 đá euro 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 đá euro 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 đá euro 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 đá euro 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 đá euro được nhận,evtinfoCon trỏ nên được chuyển đến APGEVENTRESULTCREATE *. TheConnlà kèo bóng đá euro nối được sử dụng để tạo kèo bóng đá euro 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 đá euro không thành công (trả về số 0), quy trình sự kèo bóng đá euro đó 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 đá euro cho kết quả này hoặc kết quả được sao chép từ nó.

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

Cấu trúc typedef

Khi APGEVT_RESULTCOPYSự kèo bóng đá euro được nhận,evtinfoCon trỏ nên được chuyển đến APGEVENTRESULTCOPY *. TheSRCkèo bóng đá euro 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 đá euro 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 đá euro không thành công (trả về số 0), quy trình sự kèo bóng đá euro đó 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 đá euro cho kết quả đó hoặc kết quả được sao chép từ nó.

Sự kèo bóng đá euro 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 đá euro là làm sạch dữ liệu sự kèo bóng đá euro 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 đá euro được nhận,evtinfoCon trỏ nên được đúc đến APGEVENTRESULTDESTROY *. Sự kèo bóng đá euro 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 đá euro 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 đá euro 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 thủ tục con trỏ đến một quy trình sự kèo bóng đá euro, 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 đá euro từ libpq. Chữ ký của thủ tục sự kèo bóng đá euro phải là

22069_22137

TheEVTIDtham số cho biết nàoPGEVTSự kèo bóng đá euro xảy ra. TheevtinfoCon trỏ phải được chuyển đến loại cấu trúc thích hợp để có thêm thông tin về sự kèo bóng đá euro này. TheVượt quaTham số là con trỏ được cung cấp chopqregistereventProcKhi thủ tục sự kèo bóng đá euro đượ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 đá euro 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èo bóng đá euro.

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

int pqregistereventProc (PGConn *Conn, PGEVEN

Một quy trình sự kèo bóng đá euro 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 đá euro 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 đá euro 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 đá euro 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 đá euro trong các thông báo lỗi. Giá trị này không thể lànullhoặc chuỗi không độ dài. Chuỗi tên được sao chép vàoPGConn, Vì vậy, những gì được thông qua không 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 xảy ra sự kèo bóng đá euro. Đối số này có thể lànull.

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

26361_26431

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

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

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

27756_27833

Hãy coi chừng bất kỳ lưu trữ nào được đại diện bởiDatasẽ không đượ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èo bóng đá euro quả bị phá hủy.)

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

28866_28936