TrnsDT

  • 發行項

會呼叫 TrnsDT函式，將字串從一個字碼頁轉譯到另一個字碼頁。

語法

  
WORD WINAPI TrnsDt(  
PASSSTRUCT far* PassParm);

參數

PassParm
提供的 參數。 PASSSTRUCT結構的指標，其中包含必須提供的成員，以及函式所傳回的成員。

傳回值

TrnsDT函式會在成功時傳回零。 失敗時，此函式傳回的可能值如下所示：

ERR_FILE_NOT_FOUND

如果找不到 TrnsDT 資料表檔案 (*.tbl) ，就會傳回此錯誤。 一般而言，TrnsDT會使用位於 Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows 11及Windows 10上主機 Integration Server\System 目錄的轉換資料表。 如果 TrnsDT 找不到這些資料表，它會在目前目錄中搜尋它們。

ERR_INVALID_PARAMETER

如果傳遞一或多個 PassParm 結構成員的錯誤值，就會傳回此錯誤。 不正確參數不能包含零exit_code成員、傳遞輸入來源字串為零或小於或大於 65535 個位元組的in_length、針對零或更少輸出字串緩衝區傳遞out_length、傳遞in_page或out_page包含未定義字碼頁值的成員。

ERR_BUFFER_OVERFLOW

如果輸出緩衝區對轉換的輸出字串而言太小，就會傳回此錯誤。 在這種情況下， out_length 成員會以位元組為單位傳回輸出緩衝區的必要值。 如果轉換來源字串所需的輸出緩衝區長度超過 65535 個位元組，也會傳回此錯誤。

ERR_MEMORY_ALLOCATE

如果無法配置記憶體供 TrnsDT DLL 使用，就會傳回此錯誤。