다음을 통해 공유


NlsDllCodePageTranslation 함수(gb18030.h)

플래그 설정에 따라 코드 페이지 정보를 얻거나 변환을 수행하는 데 사용됩니다.

참고 이 함수를 사용하지 마세요. 다른 버전의 Windows에서 다르게 동작할 수 있습니다. GB18030 바이트를 유니코드 문자 또는 유니코드 문자로 변환하려면 MultiByteToWideCharWideCharToMultiByte 함수를 사용합니다.
 

구문

DWORD NlsDllCodePageTranslation(
  [in]      DWORD    CodePage,
  [in]      DWORD    dwFlags,
  [in, out] LPSTR    lpMultiByteStr,
  [in]      int      cchMultiByte,
  [in, out] LPWSTR   lpWideCharStr,
  [in]      int      cchWideChar,
  [in]      LPCPINFO lpCPInfo
);

매개 변수

[in] CodePage

코드 페이지의 값입니다. 코드 페이지 값은 54936이어야 합니다. 그렇지 않으면 함수는 오류 코드를 반환합니다.

[in] dwFlags

번역을 지정하는 플래그입니다. 가능한 값은 다음 표에 정의되어 있습니다.

의미
NLS_CP_CPINFO
lpCPInfo가 가리키는 버퍼에서 코드 페이지 정보를 검색합니다. lpMultiByteStr, cchMultiByte, lpWideCharStrcchWideChar 매개 변수는 사용되지 않습니다.
NLS_CP_MBTOWC
GB18030 바이트를 유니코드 문자로 변환합니다. 원본 GB18030 문자는 lpMultiByteStr로 가리키고 cchMultiByte 는 버퍼의 바이트 수를 포함해야 합니다. 유니코드 결과는 lpWideCharStr이 가리키는 버퍼에 저장되며 cchWideChar 는 유니코드 버퍼의 문자 수를 포함해야 합니다. lpWideCharStr 또는 cchWideChar가 0이면 유니코드 결과의 예상 문자 수가 반환되고 변환이 수행되지 않습니다. 이 경우 lpCPInfo 매개 변수가 사용되지 않습니다.
NLS_CP_WCTOMB
유니코드 문자를 GB18030 바이트로 변환합니다. 원본 유니코드 문자열은 lpWideCharStr에서 가리아야 하며 cchWideChar 에는 버퍼의 문자 수가 포함되어야 합니다. GB18030 결과는 lpMultiByteStr이 가리키는 버퍼에 저장되며 cchMultiByte 는 GB18030 버퍼의 바이트 수를 포함해야 합니다. lpMultiByteStr 또는 cchMultiByte가 0이면 GB18030 결과의 바이트 수가 반환되고 변환이 수행되지 않습니다. 이 경우 lpCPInfo 매개 변수가 사용되지 않습니다.

[in, out] lpMultiByteStr

멀티 바이트 GB18030 문자를 포함하는 버퍼에 대한 포인터입니다. dwFlags 값에 따라 원본 버퍼 또는 대상 버퍼일 수 있습니다.

[in] cchMultiByte

멀티 바이트 버퍼의 바이트 수입니다.

[in, out] lpWideCharStr

유니코드 문자를 포함하는 버퍼에 대한 포인터입니다. dwFlags 값에 따라 원본 버퍼 또는 대상 버퍼일 수 있습니다.

[in] cchWideChar

유니코드 버퍼의 문자 수입니다.

[in] lpCPInfo

CPINFO 구조체에 대한 포인터입니다.

반환 값

성공하면 1을 반환합니다. 함수가 성공하지 못하면 0을 반환합니다. 확장된 오류 정보를 가져오기 위해 애플리케이션은 다음 오류 코드 중 하나를 반환할 수 있는 GetLastError를 호출할 수 있습니다.

  • ERROR_INVALID_PARAMETER. 매개 변수 값이 잘못되었습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 gb18030.h
DLL C_g18030.dll

추가 정보

MultiByteToWideChar

WideCharToMultiByte