Set_Prepare_To_Receive_Type (CPI-C)

Panggilan Set_Prepare_To_Receive_Type ( cmsptr nama fungsi) menentukan bagaimana panggilan Prepare_To_Receive berikutnya akan dijalankan. Ini mengambil alih pemrosesan persiapan untuk menerima default yang dibuat oleh Initialize_Conversation atau Accept_Conversation. Secara default, pemrosesan persiapan untuk menerima didasarkan pada tingkat sinkronisasi percakapan.

Jenis persiapan untuk menerima memengaruhi semua panggilan Prepare_To_Receive berikutnya. Ini dapat diubah dengan menerbitkan kembali Set_Prepare_To_Receive_Type.

Sintaksis

  
CM_ENTRY Set_Prepare_To_Receive_Type(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *prepare_to_receive_type,    
  CM_INT32 FAR *return_code              
);  

Parameter-parameternya

conversation_ID
Parameter yang disediakan. Menentukan pengidentifikasi untuk percakapan. Nilai parameter ini dikembalikan oleh Initialize_Conversation atau Accept_Conversation.

prepare_to_receive_type
Parameter yang disediakan. Menentukan bagaimana panggilan Prepare_To_Receive berikutnya akan dijalankan. Nilai yang mungkin adalah:

CM_PREP_TO_RECEIVE_CONFIRM
Digunakan untuk mengirim program mitra konten buffer pengiriman unit logis (LU) dan permintaan konfirmasi. Setelah menerima konfirmasi, percakapan berubah menjadi status RECEIVE.

CM_PREP_TO_RECEIVE_FLUSH
Digunakan untuk mengirim program mitra konten LUs lokal mengirim buffer dan mengubah percakapan ke status RECEIVE.

CM_PREP_TO_RECEIVE_SYNC_LEVEL
Digunakan oleh tingkat sinkronisasi percakapan untuk menentukan pemrosesan persiapan untuk menerima. Tingkat sinkronisasi default dibuat oleh Initialize_Conversation dan dapat ditimpa oleh Set_Sync_Level.

Jika tingkat sinkronisasi percakapan CM_NONE, defaultnya, konten buffer pengiriman LUs lokal dikirim ke program mitra dan percakapan berubah menjadi status RECEIVE. Jika tingkat sinkronisasi percakapan CM_CONFIRM, konten LUs lokal mengirim buffer dan permintaan konfirmasi dikirim ke program mitra. Percakapan berubah menjadi status RECEIVE ketika program mitra bermasalah Dikonfirmasi, menanggapi permintaan konfirmasi.

return_code
Kode yang dikembalikan dari panggilan ini. Kode pengembalian yang valid dicantumkan nanti dalam topik ini.

Kode Pengembalian

CM_OK
Kode pengembalian utama; panggilan berhasil dijalankan.

CM_PROGRAM_PARAMETER_CHECK
Kode pengembalian utama; salah satu hal berikut ini terjadi:

• Nilai yang ditentukan oleh prepare_to_receive_type atau conversation_ID tidak valid.

• Parameter prepare_to_receive_type diatur ke CM_PREP_TO_RECEIVE_CONFIRM, tetapi tingkat sinkronisasi percakapan diatur ke CM_NONE.

  CM_PRODUCT_SPECIFIC_ERROR
  Kode pengembalian utama; terjadi kesalahan khusus produk dan telah dicatat dalam log kesalahan produk.

Perubahan Status

Percakapan dapat berada dalam status apa pun kecuali RESET.

Tidak ada perubahan status.