Struttura PASSSTRUCT

La struttura PASSSTRUCT è definita come segue:

Sintassi

  
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
Parametro fornito. Lunghezza della struttura passata, in genere impostata su 24. Se il membro dell'opzione non è necessario o usato, questo parametro può essere impostato su 22.

exit_code
Parametro fornito e restituito. Nella voce il membro deve essere impostato su zero. In caso di restituzione, questo membro indica lo stato di uscita. I valori validi per i valori restituiti exit_code sono i seguenti:

0

Codice di uscita normale che indica che la funzione è stata completata correttamente.

1

La conversione richiesta non è supportata.

12

Il campo exit_code non è stato inizializzato correttamente su zero.

128

L'ultimo carattere nella stringa di input di origine è un byte di lead DBCS.

256

Impossibile completare la conversione perché la lunghezza della stringa di destinazione convertita risultante supera i 65535 byte.

257

Si è verificato un errore durante il tentativo di caricare uno e inizializzare uno dei file TrnsDTx.dll.

in_length
Parametro fornito. Specifica la lunghezza della stringa di origine di input in byte.

in_addr
Parametro fornito. Puntatore al buffer contenente la stringa di origine da convertire.

out_length
Parametro fornito e restituito. Specifica la lunghezza massima disponibile per la stringa tradotta di output in byte. In caso contrario, questo membro viene impostato sulla lunghezza della stringa di output convertita in caso di esito positivo o della lunghezza del buffer di output necessaria se il buffer era troppo piccolo.

out_addr
Parametro fornito. Puntatore al buffer che conterrà la stringa di destinazione di output dopo la conversione.

trns_id
Parametro fornito. Identificatore di conversione, che è sempre zero.

in_page
Parametro fornito. Specifica la tabella codici della stringa di origine in ingresso.

out_page
Parametro fornito. Specifica la tabella codici della stringa tradotta di output.

opzione
Specificato e restituito parametro se parm_length è stato impostato su 24. Come parametro fornito, questo specifica un set di opzioni che possono essere applicate al processo di conversione. I valori possibili per queste opzioni sono i seguenti:

Bit da 15 a 9

Riservato.

Bit 8

Aggiungere shift out (SO)/shift in byte (SI) alle stringhe di output convertite.

Bit 3-7

Riservato.

Bit 2

Se questo bit è impostato, convertire la stringa di input usando la tabella di codice a 1 byte specificata da IBM. Questa opzione è valida solo quando si esegue la conversione dalla tabella codici 932 a una delle tabelle codici seguenti: 037, 290, 930 o 931.

Se questo bit è zero, convertire la stringa di origine di input usando la tabella di conversione creata usando l'utilità SYSCTBL.

In caso di caratteri a byte doppio, usare sempre la tabella di conversione creata dall'utilità SYSCTBL.

Il file SYSCTBL.EXE è un programma di utilità incluso in Host Integration Server che fornisce uno strumento che può essere usato per creare tabelle di conversione personalizzate da usare con la funzione TrnsDT .

Bit 1

Se questo bit è impostato, indica che la stringa di origine di input inizia con un carattere a 2 byte. In genere, i dati host includono sempre caratteri di controllo SO/SI in coppie, ma quando si converte parte di stringhe di dati miste, è necessario avviare la conversione da un carattere a byte doppio senza il carattere di controllo SO. In questo caso, i dati stessi non dispongono di informazioni adeguate per determinare se è a doppio byte o meno, quindi è necessario impostare bit 1.

Bit 0

Se questo bit è impostato, indica che la stringa di origine di input contiene caratteri di controllo SO/SI. Bit 8 e bit 0 devono essere impostati come segue:

Conversione dal PC all'host Bit 8=1, bit 0 =0 Conversione da host a PC Bit 8=0, bit 0=1

In caso contrario, l'opzione è impostata su 4 se l'ultimo carattere è un carattere a byte doppio.