Mặc dù tất cả các mô-đun kèo bóng đá cúp c2-Logged tích hợp đều có các loại bản ghi kèo bóng đá cúp c2 riêng của chúng, nhưng cũng có một loại Record kèo bóng đá cúp c2 chung, mô tả các thay đổi đối với các trang một cách chung. Điều này rất hữu ích cho các tiện ích mở rộng cung cấp các phương thức truy cập tùy chỉnh, vì họ không thể đăng ký các thói quen làm lại kèo bóng đá cúp c2 của riêng họ.
API để xây dựng các bản ghi kèo bóng đá cúp c2 chung được xác định trong8355_8378và được triển khai trongAccess/transam/Generic_xlog.c.
8465_8561
state = GenericXlogStart (quan hệ)- Bắt đầu xây dựng một bản ghi kèo bóng đá cúp c2 chung cho mối quan hệ đã cho.
page = GenericXlogregisterBuffer (trạng thái, bộ đệm, cờ)- Đăng ký bộ đệm sẽ được sửa đổi trong bản ghi kèo bóng đá cúp c2 chung hiện tại. Hàm này trả về một con trỏ vào một bản sao tạm thời của trang của bộ đệm, nơi cần sửa đổi. (Không sửa đổi trực tiếp nội dung của bộ đệm.) Đối số thứ ba là một bitmask của các cờ áp dụng cho hoạt động. Hiện tại cờ duy nhất như vậy làGeneric_xlog_full_image, chỉ ra rằng hình ảnh toàn trang thay vì cập nhật delta nên được đưa vào bản ghi kèo bóng đá cúp c2. Thông thường, cờ này sẽ được đặt nếu trang mới hoặc đã được viết lại hoàn toàn.9420_9447có thể được lặp lại nếu hành động kèo bóng đá cúp c2-Logged cần sửa đổi nhiều trang.
9544_9615
GenericXlogfinish (State)- Áp dụng các thay đổi cho bộ đệm và phát ra bản ghi kèo bóng đá cúp c2 chung.
Xây dựng bản ghi kèo bóng đá cúp c2 có thể bị hủy giữa bất kỳ bước nào trên bằng cách gọiGenericXLogabort (State). Điều này sẽ loại bỏ tất cả kèo bóng đá cúp c2 thay đổi cho kèo bóng đá cúp c2 bản sao hình ảnh trang.
Xin lưu ý các điểm sau khi sử dụng cơ sở ghi kèo bóng đá cúp c2 chung:
10068_10173GenericXLogRegisterBuffer (). Nói cách khác, mã tạo ra các bản ghi kèo bóng đá cúp c2 chung không bao giờ được gọiBufferGetPage ()cho chính nó. Tuy nhiên, nó vẫn là trách nhiệm của người gọi đối với pin/unpin và khóa/mở khóa kèo bóng đá cúp c2 bộ đệm vào thời điểm thích hợp. Khóa độc quyền phải được giữ trên mỗi bộ đệm mục tiêu từ trướcGenericXLogRegisterBuffer ()kèo bóng đá cúp c2 đến sauGenericXlogfinish ().
Đăng ký bộ đệm (Bước 2) và sửa đổi hình ảnh trang (Bước 3) có thể được trộn tự do, tức là, cả hai bước có thể được lặp lại trong bất kỳ chuỗi nào. Hãy nhớ rằng kèo bóng đá cúp c2 bộ đệm nên được đăng ký theo cùng một thứ tự trong đó kèo bóng đá cúp c2 khóa sẽ được lấy trên chúng trong quá trình phát lại.
Số lượng bộ đệm tối đa có thể được đăng ký cho bản ghi kèo bóng đá cúp c2 chung làMAX_GENERIC_XLOG_PAGES11085_11139
kèo bóng đá cúp c2 chung cho rằng các trang cần sửa đổi có bố cục tiêu chuẩn và đặc biệt là không có dữ liệu hữu ích giữaPD_LOWERvàPD_UPPER.
Vì bạn đang sửa đổi kèo bóng đá cúp c2 bản sao của kèo bóng đá cúp c2 trang bộ đệm,GenericXlogStart ()không bắt đầu một phần quan trọng. Vì vậy, bạn có thể thực hiện phân bổ bộ nhớ, ném lỗi, v.v.GenericXlogStart ()vàGenericXlogfinish (). Phần quan trọng thực tế duy nhất có mặt bên trongGenericXlogfinish (). Không cần phải lo lắng về việc gọiGenericXLogabort ()Trong khi thoát lỗi.
GenericXlogfinish ()Chăm sóc đánh dấu bộ đệm bẩn và đặt LSN của họ. Bạn không cần phải làm điều này một cách rõ ràng.
Đối với các mối quan hệ chưa được tính, mọi thứ đều hoạt động giống nhau ngoại trừ việc không có bản ghi kèo bóng đá cúp c2 thực tế nào được phát ra. Do đó, bạn thường không cần phải thực hiện bất kỳ kiểm tra rõ ràng nào cho các mối quan hệ chưa được tính.
Chức năng kèo bóng đá cúp c2 Redo chung sẽ có được các khóa độc quyền cho bộ đệm theo thứ tự giống như chúng đã được đăng ký. Sau khi làm lại tất cả các thay đổi, các khóa sẽ được phát hành theo cùng một thứ tự.
nếuGeneric_xlog_full_imagekhông được chỉ định cho bộ đệm đã đăng ký, bản ghi kèo bóng đá cúp c2 chung chứa một đồng bằng giữa hình ảnh trang cũ và trang mới. Delta này dựa trên so sánh byte-byte. Điều này không nhỏ gọn cho trường hợp di chuyển dữ liệu trong một trang và có thể được cải thiện trong tương lai.