TrnsDT

La funzione TrnsDT viene chiamata per tradurre una stringa da una tabella codici a un'altra.

Sintassi

  
WORD WINAPI TrnsDt(  
PASSSTRUCT far* PassParm);  

Parametri

PassParm
Parametro fornito. Puntatore a una struttura PASSSTRUCT contenente membri che devono essere forniti, nonché membri restituiti dalla funzione.

Valore restituito

La funzione TrnsDT restituisce zero in caso di esito positivo. In caso di errore, i valori possibili restituiti da questa funzione sono i seguenti:

ERR_FILE_NOT_FOUND

Questo errore viene restituito se non è stato possibile trovare i file di tabella TrnsDT (*.tbl). In genere TrnsDT usa le tabelle di conversione disponibili nella directory Host Integration Server\System in Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 e Windows 10. Se TrnsDT non riesce a trovare queste tabelle, le cerca nella directory corrente.

ERR_INVALID_PARAMETER

Questo errore viene restituito se è stato passato un valore non valido per uno o più membri della struttura PassParm . I parametri non validi possono includere l'assenza di zeri del membro exit_code , passando un in_length per la stringa di origine di input pari o inferiore a 65535 byte, passando un out_length per il buffer di stringa di output pari o inferiore a zero, passando in_page o out_page membri contenenti valori di tabella codici non definiti.

ERR_BUFFER_OVERFLOW

Questo errore viene restituito se il buffer di output è troppo piccolo per la stringa di output convertita. In questi casi, il membro out_length restituisce con il valore necessario in byte per il buffer di output. Questo errore viene restituito anche se la lunghezza del buffer di output necessario per convertire la stringa di origine supera i 65535 byte.

ERR_MEMORY_ALLOCATE

Questo errore viene restituito se non è stato possibile allocare memoria per l'uso dalla DLL TrnsDT.