TrnsDT

Die TrnsDT-Funktion wird aufgerufen, um eine Zeichenfolge von einer Codepage 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 bei Erfolg null zurück. Bei Einem Fehler werden von dieser Funktion folgende Werte zurückgegeben:

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, sucht es sie im aktuellen Verzeichnis.

ERR_INVALID_PARAMETER

Dieser Fehler wird zurückgegeben, wenn ein ungültiger Wert für mindestens ein Element der PassParm-Struktur übergeben wurde. Ungültige Parameter können das Nicht-Nullen des exit_code-Members , das Übergeben einer in_length für die Eingabequellzeichenfolge von 0 oder kleiner oder größer als 65535 Byte, das Übergeben einer out_length für den Ausgabezeichenfolgenpuffer von 0 oder weniger, das Übergeben von in_page oder out_page Membern, die undefinierte Codepagewerte enthalten, umfassen.

ERR_BUFFER_OVERFLOW

Dieser Fehler wird zurückgegeben, wenn der Ausgabepuffer für die konvertierte Ausgabezeichenfolge zu klein ist. In solchen Fällen gibt der out_length Member mit dem erforderlichen Wert in Bytes 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 arbeitsspeicher nicht für die Verwendung durch die TrnsDT-DLL zugewiesen werden konnte.