TrnsDT

La funzione TrnsDT viene chiamata per convertire 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 i membri che devono essere forniti e i membri restituiti dalla funzione.

Valore restituito

La funzione TrnsDT restituisce zero in corrispondenza dell'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 che si trovano nella directory Host Integration Server\System in Windows Server 2003 R2 SP2, Windows Vista SP2, Windows 7, Windows Server 2008 SP2 e Windows Server 2012. 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'azzeramento del membro exit_code , il passaggio di un in_length per la stringa di origine di input di zero o minore o maggiore di 65535 byte, il passaggio di un out_length per il buffer della stringa di output pari o inferiore a zero, il passaggio di membri in_page o out_page 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 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 necessaria 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 da parte della DLL di TrnsDT.