TrnsDT

Die TrnsDT-Funktion wird aufgerufen, um eine Zeichenfolge von einer Codeseite in eine andere zu übersetzen.

Syntax

  
WORD WINAPI TrnsDt(  
PASSSTRUCT far* PassParm);  

Parameter

PassParm
Angegebener Parameter. Ein Zeiger auf eine PASSSTRUCT-Struktur , die Member enthält, die bereitgestellt werden müssen, sowie Member, die von der Funktion zurückgegeben werden.

Rückgabewert

Die TrnsDT-Funktion gibt null bei Erfolg zurück. Fehler: Mögliche Werte, die von dieser Funktion zurückgegeben werden, sind wie folgt:

ERR_FILE_NOT_FOUND

Dieser Fehler wird zurückgegeben, wenn die TrnsDT-Tabellendateien (*.tbl) nicht gefunden werden konnten. Normalerweise verwendet TrnsDT die Konvertierungstabellen im Verzeichnis "Host Integration Server\System" unter Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 und Windows 10. Wenn TrnsDT diese Tabellen nicht finden kann, wird diese im aktuellen Verzeichnis gesucht.

ERR_INVALID_PARAMETER

Dieser Fehler wird zurückgegeben, wenn für mindestens ein Element der PassParm-Struktur ein ungültiger Wert übergeben wurde. Ungültige Parameter können kein Nullen des exit_code-Elements enthalten, eine in_length für die Eingabequellzeichenfolge null oder kleiner oder größer als 65535 Byte übergeben und einen out_length für den Ausgabezeichenfolgenpuffer null oder weniger übergeben, in_page oder out_page Elemente übergeben, die nicht definierte Codepagewerte enthalten.

ERR_BUFFER_OVERFLOW

Dieser Fehler wird zurückgegeben, wenn der Ausgabepuffer für die konvertierte Ausgabezeichenfolge zu klein ist. In solchen Fällen gibt das out_length-Element den erforderlichen Wert in Byte für den Ausgabepuffer zurück. Dieser Fehler wird auch zurückgegeben, wenn die Zum Konvertieren der Quellzeichenfolge erforderliche Länge des Ausgabepuffers 65535 Bytes überschreitet.

ERR_MEMORY_ALLOCATE

Dieser Fehler wird zurückgegeben, wenn der Arbeitsspeicher nicht für die Verwendung durch die TrnsDT-DLL zugeordnet werden konnte.