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;  

Membri

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. All'avvio, questo membro deve essere impostato a zero. Al ritorno, 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 guida 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. Al ritorno, questo membro viene impostato sulla lunghezza della stringa di output convertita in caso di successo o sulla 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 pagina codice della stringa sorgente in ingresso.

out_page
Parametro fornito. Specifica la pagina di codice della stringa di output tradotta.

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

Bit da 15 a 9

Riservato.

Bit 8

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

Bit da 3 a 7

Riservato.

Bit 2

Se questo bit è impostato, convertire usando la tabella di codice a 1 byte specificata da IBM la stringa di input. 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 si rileva che questo bit è zero, convertire la stringa di origine di input utilizzando la tabella di conversione generata con 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 di restituzione, l'opzione è impostata su 4 se l'ultimo carattere è un carattere a byte doppio.