Set_Send_Type (CPI-C)

Panggilan Set_Send_Type ( cmsst nama fungsi) menentukan bagaimana data akan dikirim oleh panggilan Send_Data berikutnya. Ini mengambil alih jenis pengiriman default yang dibuat oleh Initialize_Conversation atau Accept_Conversation. Jenis pengiriman default adalah CM_BUFFER_DATA, menunjukkan bahwa data saja (dan tidak ada informasi kontrol) yang akan dikirim.

Nilai send_type memengaruhi semua panggilan Send_Data berikutnya. Ini dapat diubah dengan menerbitkan kembali Set_Send_Type.

Sintaksis

  
CM_ENTRY Set_Send_Type(   
  unsigned char FAR *conversation_ID,    
    CM_INT32 FAR *send_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.

send_type
Parameter yang disediakan. Menentukan bagaimana data dikirim oleh panggilan Send_Data berikutnya. Nilai yang mungkin adalah:

CM_BUFFER_DATA
Data yang diarahkan oleh Send_Data disimpan dalam buffer hingga buffer terisi atau dibersihkan.

CM_SEND_AND_FLUSH
Data yang ditujukkan oleh Send_Data akan segera dikirim.

CM_SEND_AND_CONFIRM
Data akan segera dikirim dengan permintaan konfirmasi.

CM_SEND_AND_PREP_TO_RECEIVE
Data akan segera dikirim bersama dengan pemberitahuan ke program mitra bahwa status percakapan untuk program pengiriman berubah menjadi RECEIVE.

CM_SEND_AND_DEALLOCATE
Data akan segera dikirim bersama dengan pemberitahuan dealokasi.

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 conversation_ID atau send_type tidak valid.

• Parameter send_type diatur ke CM_SEND_AND_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.

Komentar

Nilai send_type yang menyebabkan informasi tambahan dikirim dengan data yang ditujukan oleh Send_Data memungkinkan Anda melakukan ekonomis pada jumlah panggilan yang dikeluarkan. Tabel berikut ini meringkas Send_Data kesetaraan.

Send_Data dengan send_type diatur ke nilai ini	Samakan dengan Send_Data dengan send_type diatur ke CM_BUFFER_DATA diikuti oleh
CM_SEND_AND_FLUSH	Flush
CM_SEND_AND_CONFIRM	Mengkonfirmasi
CM_SEND_AND_PREP_TO_RECEIVE	Prepare_To_Receive
CM_SEND_AND_DEALLOCATE	Batalkan alokasi