GetAppcReturnCode

Fungsi GetAppcReturnCode mengonversi kode pengembalian primer dan sekunder di blok kontrol kata kerja menjadi string yang dapat dicetak. Fungsi ini menyediakan serangkaian string kesalahan standar untuk digunakan oleh aplikasi APPC seperti 5250 emulator.

Sintaksis

  
    int WINAPI GetAppcReturnCode(   
struct appc_hdr FAR * vpb,  
UINTbuffer_length,  
unsigned char FAR * buffer_addr);  

Parameter-parameternya

vpb
Parameter yang disediakan. Menentukan alamat blok kontrol kata kerja.

buffer_length
Parameter yang disediakan. Menentukan panjang buffer yang diacu oleh buffer_addr. Panjang yang disarankan adalah 256.

buffer_addr
Parameter yang disediakan. Menentukan alamat buffer yang akan menyimpan string yang diformat dan diakhiri dengan null.

Mengembalikan Nilai

Fungsi GetAppcReturnCode mengembalikan nilai positif pada keberhasilan yang menunjukkan panjang string kesalahan yang diteruskan kembali dalam buffer_addr.

Nilai pengembalian nol menunjukkan kesalahan. Di Microsoft Windows, panggilan ke GetLastError menyediakan kode pengembalian kesalahan aktual sebagai berikut:

0x20000001
Parameter tidak valid; fungsi tidak dapat membaca dari blok kontrol kata kerja yang ditentukan atau tidak dapat menulis ke buffer yang ditentukan.

0x20000002
Buffer yang ditentukan terlalu kecil.

0x20000003
Pustaka string APPC APPCST32.DLL tidak dapat dimuat.

Komentar

String kesalahan deskriptif yang dikembalikan dalam buffer_addr tidak berakhir dengan karakter baris baru (\n).

String kesalahan deskriptif terkandung dalam APPCST32.DLL dan dapat disesuaikan untuk bahasa yang berbeda.