TrnsDT

调用 TrnsDT 函数将字符串从一个代码页转换为另一个代码页。

Syntax

  
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 上的 Host Integration Server\System 目录中的转换表。 如果 TrnsDT 找不到这些表,则会在当前目录中搜索它们。

ERR_INVALID_PARAMETER

如果为 PassParm 结构的一个或多个成员传递了错误的值,则返回此错误。 无效参数不能包括零exit_code成员、为输入源字符串传递in_length(小于或小于 65535 字节)、为输出字符串缓冲区传递out_length(为零或更少)传递in_pageout_page包含未定义代码页值的成员。

ERR_BUFFER_OVERFLOW

如果输出缓冲区太小而无法转换的输出字符串,则返回此错误。 在这种情况下, out_length 成员返回输出缓冲区所需的值(以字节为单位)。 如果转换源字符串所需的输出缓冲区长度超过 65535 字节,也会返回此错误。

ERR_MEMORY_ALLOCATE

如果无法分配内存供 TrnsDT DLL 使用,则返回此错误。