nl::Weave::Profiles::BDX_Development

ระบบจะเรียกเครื่องจัดการนี้ทุกครั้งที่พบข้อผิดพลาดของ Weave ซึ่งไม่สามารถแสดงผลโดยตรงผ่านรหัสข้อผิดพลาดไปยังขั้นตอนการควบคุมที่กำหนดโดยแอปพลิเคชันของผู้ใช้

กล่าวคือ หากข้อผิดพลาดเกิดขึ้นภายในเครื่องจัดการอื่นที่ลายเซ็นมีรูปแบบผลลัพธ์เป็นโมฆะ (เช่น เพื่อตอบสนองข้อความ Weave ที่เข้ามาหรือแม้แต่ส่งโดยโปรโตคอล) ระบบจะเรียกเครื่องจัดการนี้เพื่อให้ผู้ใช้สามารถพิจารณาว่าการถ่ายโอนสามารถกู้คืนและดำเนินการต่อได้หรือไม่ หรือควรเรียก Shutdown() โปรดทราบว่าอาจเกิดข้อผิดพลาดขึ้นก่อนที่จะมีการโอนออบเจ็กต์ BDXTransfer มากเกินไป (เช่น การโอน BDXTransfer ในกรณีดังกล่าว Weave จะบันทึกข้อผิดพลาดดังกล่าวและโปรโตคอลจะจัดการการล้างสถานะที่จําเป็นซึ่งจัดสรรไว้

Get a block of data to be transmitted.

ตัวเรียกใช้มีพื้นที่บัฟเฟอร์ (บัฟเฟอร์และความยาวของบัฟเฟอร์ซึ่งส่งผ่านโดยการอ้างอิง) Callee (แอปพลิเคชันผู้ใช้) ควรใช้บัฟเฟอร์ที่ให้ไว้ แต่ด้วยเหตุผลความเข้ากันได้แบบย้อนหลัง อาจแสดงบัฟเฟอร์ของตัวเอง Callee ต้องป้อนไม่เกิน aLength ของไบต์ ในทางกลับกัน aLength จะแสดงจำนวนไบต์จริงที่อ่านลงในบัฟเฟอร์

จัดการบล็อกของข้อมูลที่ระบุด้วย aDataBlock ความยาว aLength

ซึ่งอาจเกี่ยวข้องกับการเขียนข้อมูลลงในไฟล์และปิดไฟล์ดังกล่าวหาก isLastBlock เป็นจริง

จะมีการเรียกกลับเมื่อปลายทางยอมรับ ReceiveInit ที่ส่งไปก่อนหน้านี้

คุณสามารถใช้โอกาสนี้เพื่อเปิดไฟล์หรือจัดสรรทรัพยากรสำหรับการโอน หากคุณไม่ได้ดำเนินการดังกล่าวตั้งแต่เริ่มต้น

มีการเรียกกลับเมื่อได้รับข้อความ ReceiveInit

มีหน้าที่ระบุว่าคุณต้องการยอมรับส่วน "รับ" หรือไม่ และถ้าเป็นเช่นนั้น ให้ตั้งค่า aXfer->mIsaccept=true เพื่อให้โปรโตคอลส่งข้อความยอมรับไปยังผู้เริ่มต้น ออบเจ็กต์ BDXTransfer จะเริ่มต้นขึ้นตามการตั้งค่าเริ่มต้น บริเวณนี้เป็นที่ที่เหมาะสมในการแนบสถานะเฉพาะแอปพลิเคชัน (เช่น เปิดไฟล์แบบเปิด เป็นต้น) กับ aXfer->mAppState นอกจากนี้ คุณควรแนบตัวแฮนเดิลที่จำเป็น เช่น การจัดการบล็อกเข้ากับออบเจ็กต์ BDXTransfer ในจุดนี้ ถ้าพบรหัสข้อผิดพลาดอื่นที่ไม่ใช่ kStatus_Success จะถือว่าการโอนถูกปฏิเสธและโปรโตคอลจะจัดการการส่งข้อความปฏิเสธพร้อมรหัส

เรียกใช้เมื่อปลายทางปฏิเสธข้อความ Init ก่อนหน้านี้

ระบบจะเรียกกลับเมื่อปลายทางยอมรับ SendInit ที่ส่งไปก่อนหน้านี้

คุณสามารถใช้โอกาสนี้เพื่อเปิดไฟล์หรือจัดสรรทรัพยากรสำหรับการโอน หากคุณไม่ได้ดำเนินการดังกล่าวตั้งแต่เริ่มต้น

มีการเรียกกลับเมื่อได้รับข้อความ SendInit

มีหน้าที่ระบุว่าคุณต้องการยอมรับ SendInit หรือไม่ และหากใช่ ให้ตั้งค่า aXfer->mIsaccept=true เพื่อให้โปรโตคอลส่งข้อความยอมรับไปยังผู้เริ่มต้น ออบเจ็กต์ BDXTransfer จะเริ่มต้นขึ้นตามการตั้งค่าเริ่มต้น บริเวณนี้เป็นที่ที่เหมาะสมในการแนบสถานะเฉพาะแอปพลิเคชัน (เช่น เปิดไฟล์แบบเปิด เป็นต้น) กับ aXfer->mAppState นอกจากนี้ คุณควรแนบตัวแฮนเดิลที่จำเป็น เช่น การจัดการบล็อกเข้ากับออบเจ็กต์ BDXTransfer ในจุดนี้ หากมีการส่งคืนรหัสข้อผิดพลาดอื่นที่ไม่ใช่ WEAVE_NO_ERROR จะถือว่าการโอนถูกปฏิเสธและโปรโตคอลจะจัดการการส่งข้อความปฏิเสธพร้อมรหัสดังกล่าว

จัดการกรณีที่การโอนเสร็จสิ้นแล้ว

จัดการข้อความ TransferError ที่ได้รับหรือส่งโดย BDX

หมายเหตุ: คาดว่าการโอน BDX อาจกู้คืนได้ (เช่น เกิดชั่วคราวจาก PacketBuffers ในขณะนี้) ดังนั้นตัวเลือกในการเรียก Shutdown() จึงเป็นไปให้กับโปรแกรมเมอร์แอปพลิเคชันและโค้ดเรียกกลับที่ระบุไว้ สิ่งที่ต้องทำ: ยืนยันข้อมูลนี้และตรวจเทียบโดยใช้ภาษาในเอกสาร BDX ซึ่งระบุว่า "[A TransferError] ส่งโดยฝ่ายใดฝ่ายหนึ่งได้ทุกเมื่อเพื่อให้การโอนข้อมูลจำนวนมากสิ้นสุดก่อนเวลาอันควร"

GetBDXAckFlag จะแสดงแฟล็กที่เหมาะสมสำหรับช่อง RequestAck ตามการเชื่อมต่อของบริบท Exchange (ไม่มีคำขอ ack สำหรับ TCP) และอิงตามการรองรับเวลาคอมไพล์สำหรับ WRMP