TrnsDT 函式是用來將字串從一個代碼頁轉換到另一個代碼頁。
語法
WORD WINAPI TrnsDt(
PASSSTRUCT far* PassParm);
參數
帕斯帕爾馬
提供的參數。 指向一個包含必須提供成員以及函式回傳的成員的 PASSSTRUCT 結構指標。
傳回值
TrnsDT 函數成功時回傳為零。 當函數失敗時，該函數可能返回的值如下：
ERR_FILE_NOT_FOUND
若找不到 TrnsDT 表格檔案（*.tbl），則會回傳此錯誤。 通常 TrnsDT 會使用位於 Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows 11 及 Windows 10 的 Host Integration Server\System 目錄中的轉換表。 如果 TrnsDT 找不到這些資料表，就會在目前的目錄中搜尋它們。
ERR_INVALID_PARAMETER
若 PassParm 結構中一個或多個成員傳入錯誤值，則會回傳此錯誤。 無效參數可能包括未將 exit_code 成員歸零、輸入原始字串的 in_length 為零或以下或大於 65535 位元組、輸出字串緩衝區為零或以下的 out_length 、通過包含未定義碼頁值的 in_page 或 out_page 成員。
ERR_BUFFER_OVERFLOW
若輸出緩衝區容量過小，無法容納轉換後的輸出字串，則會回傳此錯誤。 在這種情況下， out_length 成員會回傳出輸出緩衝區所需的位元組值。 若轉換來源字串所需的輸出緩衝區長度超過65535位元組，也會回傳此錯誤。
ERR_MEMORY_ALLOCATE
若無法將記憶體分配給 TrnsDT DLL 使用，則會回傳此錯誤。