TrnsDT

La fonction TrnsDT est appelée pour traduire une chaîne d’une page de code à une autre.

Syntaxe

  
WORD WINAPI TrnsDt(  
PASSSTRUCT far* PassParm);  

Paramètres

PassParm
Paramètre fourni. Pointeur vers une structure PASSSTRUCT contenant des membres qui doivent être fournis ainsi que des membres retournés par la fonction.

Valeur renvoyée

La fonction TrnsDT retourne zéro en cas de réussite. En cas d’échec, les valeurs possibles retournées par cette fonction sont les suivantes :

ERR_FILE_NOT_FOUND

Cette erreur est retournée si les fichiers de table TrnsDT (*.tbl) sont introuvables. Normalement, TrnsDT utilise les tables de conversion situées dans le répertoire Host Integration Server\System sur Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 et Windows 10. Si TrnsDT ne trouve pas ces tables, il les recherche dans le répertoire actif.

ERR_INVALID_PARAMETER

Cette erreur est retournée si une valeur incorrecte a été transmise pour un ou plusieurs membres de la structure PassParm . Les paramètres non valides peuvent inclure le non-zéro du membre exit_code , le passage d’une in_length pour la chaîne source d’entrée de zéro ou inférieur ou supérieur à 65535 octets, le passage d’un out_length pour la mémoire tampon de chaîne de sortie de zéro ou moins, le passage de in_page ou out_page membres contenant des valeurs de codepage non définies.

ERR_BUFFER_OVERFLOW

Cette erreur est retournée si la mémoire tampon de sortie est trop petite pour la chaîne de sortie convertie. Dans ce cas, le membre out_length retourne avec la valeur nécessaire en octets pour la mémoire tampon de sortie. Cette erreur est également retournée si la longueur de la mémoire tampon de sortie nécessaire pour convertir la chaîne source dépasse 65535 octets.

ERR_MEMORY_ALLOCATE

Cette erreur est retournée si la mémoire n’a pas pu être allouée pour une utilisation par la DLL TrnsDT.