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.