Struktur PASSSTRUCT

Struktur PASSSTRUCT didefinisikan sebagai berikut:

Sintaksis

  
typedef struct tagPassParm {  
    WORD    parm_length;  
    WORD    exit_code;  
    WORD    in_length;  
    LPBYTE  in_addr;  
    WORD    out_length;  
    LPBYTE  out_addr;  
    WORD    trns_id;  
    WORD    in_page;  
    WORD    out_page;  
    WORD    option;  
} PASSSTRUCT;  

Members

parm_length
Parameter yang disediakan. Panjang struktur yang dilewati, biasanya diatur ke 24. Jika anggota opsi tidak diperlukan atau digunakan, parameter ini dapat diatur ke 22.

exit_code
Parameter yang disediakan dan dikembalikan. Saat masuk, anggota ini harus diatur ke nol. Saat kembali, anggota ini menunjukkan status keluar. Nilai hukum untuk nilai exit_code yang dikembalikan adalah sebagai berikut:

0

Kode keluar normal yang menunjukkan fungsi berhasil diselesaikan.

1

Konversi yang diminta tidak didukung.

12

Bidang exit_code tidak diinisialisasi dengan benar menjadi nol.

128

Karakter terakhir dalam string input sumber adalah karakter DBCS byte awal.

256

Konversi tidak dapat berhasil diselesaikan karena panjang string tujuan yang dikonversi yang dihasilkan melebihi 65535 byte.

257

Terjadi kesalahan saat mencoba memuat satu dan menginisialisasi salah satu file TrnsDTx.dll.

in_length
Parameter yang disediakan. Menentukan ukuran string sumber input dalam satuan byte.

in_addr
Parameter yang disediakan. Penunjuk ke buffer yang berisi string sumber yang akan dikonversi.

out_length
Parameter yang disediakan dan dikembalikan. Menentukan panjang maksimum yang tersedia untuk output yang diterjemahkan string dalam byte. Setelah kembali, anggota ini diatur ke panjang string output yang telah dikonversi jika berhasil, atau ke panjang buffer output yang dibutuhkan jika buffer terlalu kecil.

out_addr
Parameter yang disediakan. Penunjuk ke buffer yang akan berisi string tujuan output setelah konversi.

trns_id
Parameter yang disediakan. Pengidentifikasi konversi, yang senantiasa bernilai nol.

di_halaman
Parameter yang disediakan. Menentukan halaman kode dari string sumber masuk.

out_page
Parameter yang disediakan. Menentukan halaman kode dari string terjemahan keluaran.

pilihan
Parameter yang disediakan dan dikembalikan jika parm_length diatur ke 24. Sebagai parameter yang disediakan, ini menentukan serangkaian opsi yang dapat diterapkan ke proses terjemahan. Nilai yang mungkin untuk opsi ini adalah sebagai berikut:

Bit 15-9

Direservasi.

Bit 8

Tambahkan shift out (SO)/shift in (SI) byte ke string output yang dikonversi.

Bit 3 hingga 7

Direservasi.

Bit 2

Jika bit ini diatur, maka konversi string input menggunakan tabel kode 1-byte yang ditentukan oleh IBM. Opsi ini hanya valid saat mengonversi dari halaman kode 932 ke salah satu halaman kode berikut: 037, 290, 930, atau 931.

Jika bit ini nol, konversikan string sumber input menggunakan tabel konversi yang dibuat menggunakan utilitas SYSCTBL.

Dalam kasus karakter byte ganda, selalu gunakan tabel konversi yang dibuat oleh utilitas SYSCTBL.

File SYSCTBL.EXE adalah program utilitas yang disertakan dengan Server Integrasi Host yang menyediakan alat yang dapat digunakan untuk membuat tabel konversi kustom untuk digunakan dengan fungsi TrnsDT .

Bit 1

Jika bit ini diatur, maka menunjukkan bahwa string sumber input dimulai dengan karakter 2-byte. Umumnya, data host selalu menyertakan karakter kontrol SO/SI berpasangan, tetapi saat mengonversi bagian dari string data campuran, perlu untuk memulai konversi dari karakter byte ganda tanpa karakter kontrol SO. Dalam hal ini, data itu sendiri tidak memiliki informasi yang memadai untuk menentukan apakah itu byte ganda atau tidak, jadi bit 1 harus diatur.

Bit 0

Jika bit ini diatur, maka menunjukkan bahwa string sumber input berisi karakter kontrol SO/SI. Bit 8 dan bit 0 harus diatur sebagai berikut:

Konversi dari PC ke host Bit 8=1, bit 0 =0 Konversi dari host ke PC Bit 8=0, bit 0=1

Saat kembali, opsi diatur ke 4 jika karakter terakhir adalah karakter byte ganda.