TrnsDT

呼叫 TrnsDT 函式,將字串從某個字碼頁轉譯成另一個字碼頁。

語法

  
WORD WINAPI TrnsDt(  
PASSSTRUCT far* PassParm);  

參數

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

傳回值

TrnsDT函數會在成功時傳回零。 失敗時,此函數所傳回的可能值如下:

ERR_FILE_NOT_FOUND

如果找不到 TrnsDT 資料表檔案 ( *. mdm.tbl.user) ,就會傳回此錯誤。 通常, TrnsDT會使用位於 Windows Server 2003 R2 SP2、Windows Vista SP2、Windows 7、Windows Server 2008 SP2 和 Windows Server 2012 的 Host Integration Server \System 目錄中的轉換表。 如果 TrnsDT 找不到這些資料表,它會在目前的目錄中搜尋這些資料表。

ERR_INVALID_PARAMETER

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

ERR_BUFFER_OVERFLOW

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

ERR_MEMORY_ALLOCATE

如果無法配置記憶體給 TrnsDT DLL 使用,則會傳回此錯誤。