Função NlsDllCodePageTranslation (gb18030.h)

Artigo
08/23/2023

Usado para obter informações da página de código ou fazer a conversão, dependendo das configurações do sinalizador.

Nota Não use essa função. Ele pode se comportar de forma diferente em diferentes versões do Windows. Para converter bytes GB18030 em caracteres Unicode ou Caracteres Unicode em bytes GB18030, use as funções MultiByteToWideChar e WideCharToMultiByte .

Sintaxe

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
);

Parâmetros

[in] CodePage

O valor da página de código. O valor da página de código deve ser 54936. Caso contrário, a função retornará um código de erro.

[in] dwFlags

Sinalizadores que especificam a tradução. Os valores possíveis são definidos na tabela a seguir.

Valor	Significado
NLS_CP_CPINFO	Recupere informações da página de código no buffer apontado por lpCPInfo. Os parâmetros lpMultiByteStr, cchMultiByte, lpWideCharStr e cchWideChar não são usados.
NLS_CP_MBTOWC	Converter GB18030 bytes em caracteres Unicode. Os caracteres GB18030 de origem devem ser apontados por lpMultiByteStr e cchMultiByte deve conter a contagem de bytes do buffer. O resultado Unicode é armazenado no buffer apontado por lpWideCharStr e cchWideChar deve conter a contagem de caracteres do buffer Unicode. Se lpWideCharStr ou cchWideChar for 0, a contagem de caracteres esperada do resultado Unicode será retornada e nenhuma conversão será feita. O parâmetro lpCPInfo não é usado nesse caso.
NLS_CP_WCTOMB	Converter caracteres Unicode em GB18030 bytes. A cadeia de caracteres Unicode de origem deve ser apontada por lpWideCharStr e cchWideChar deve conter a contagem de caracteres do buffer. O resultado GB18030 é armazenado no buffer apontado por lpMultiByteStr e cchMultiByte deve conter a contagem de bytes do buffer GB18030. Se lpMultiByteStr ou cchMultiByte for 0, a contagem de bytes do resultado GB18030 será retornada e nenhuma conversão será feita. O parâmetro lpCPInfo não é usado nesse caso.

[in, out] lpMultiByteStr

Ponteiro para um buffer que contém caracteres GB18030 multibyte. Pode ser um buffer de origem ou de destino, dependendo do valor de dwFlags.

[in] cchMultiByte

Contagem de bytes do buffer multibyte.

[in, out] lpWideCharStr

Ponteiro para um buffer que contém caracteres Unicode. Pode ser um buffer de origem ou de destino, dependendo do valor de dwFlags.

[in] cchWideChar

Contagem de caracteres do buffer Unicode.

[in] lpCPInfo

Ponteiro para uma estrutura CPINFO .

Valor retornado

Retorna 1 se tiver êxito. Se a função não for bem-sucedida, ela retornará 0. Para obter informações de erro estendidas, o aplicativo pode chamar GetLastError, que pode retornar um dos seguintes códigos de erro:

ERROR_INVALID_PARAMETER. Qualquer um dos valores de parâmetro era inválido.

Requisitos


Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gb18030.h
DLL	C_g18030.dll

Confira também

MultiByteToWideChar

WideCharToMultiByte

Compartilhar via