TrnsDT

TrnsDT 함수는 한 코드 페이지에서 다른 코드 페이지로 문자열을 변환하기 위해 호출됩니다.

구문

  
WORD WINAPI TrnsDt(  
PASSSTRUCT far* PassParm);  

매개 변수

PassParm
제공된 매개 변수입니다. 제공되어야 하는 멤버와 함수에서 반환되는 멤버를 포함하는 PASSSTRUCT 구조체에 대한 포인터입니다.

반환 값

TrnsDT 함수는 성공하면 0을 반환합니다. 실패 시 이 함수에서 반환할 수 있는 값은 다음과 같습니다.

ERR_FILE_NOT_FOUND

TrnsDT 테이블 파일(*.tbl)을 찾을 수 없는 경우 이 오류가 반환됩니다. 일반적으로 TrnsDT는 Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 및 Windows 10 호스트 통합 서버\시스템 디렉터리에 있는 변환 테이블을 사용합니다. TrnsDT에서 이러한 테이블을 찾을 수 없는 경우 현재 디렉터리에서 검색합니다.

ERR_INVALID_PARAMETER

이 오류는 PassParm 구조체의 멤버 중 하나 이상에 대해 잘못된 값이 전달된 경우 반환됩니다. 잘못된 매개 변수에는 exit_code 멤버를 0으로 지정하지 않고, 0 또는 65535바이트보다 큰 입력 소스 문자열 에 대한 in_length 전달하고, 0 이하의 출력 문자열 버퍼에 대한 out_length 전달하고, 정의되지 않은 코드 페이지 값을 포함하는 in_page 또는 out_page 멤버를 전달하는 것이 포함될 수 있습니다.

ERR_BUFFER_OVERFLOW

출력 버퍼가 변환된 출력 문자열에 비해 너무 작은 경우 이 오류가 반환됩니다. 이러한 경우 out_length 멤버는 출력 버퍼에 필요한 값을 바이트 단위로 반환합니다. 원본 문자열을 변환하는 데 필요한 출력 버퍼의 길이가 65535바이트보다 큰 경우에도 이 오류가 반환됩니다.

ERR_MEMORY_ALLOCATE

이 오류는 TrnsDT DLL에서 사용하기 위해 메모리를 할당할 수 없는 경우 반환됩니다.