Compartilhar via


Função EngMultiByteToWideChar (winddi.h)

A função EngMultiByteToWideChar converte uma cadeia de caracteres de origem ANSI em uma cadeia de caracteres largos usando a página de código especificada.

Sintaxe

ENGAPI INT EngMultiByteToWideChar(
  [in]            UINT   CodePage,
  [out, optional] LPWSTR WideCharString,
  [in]            INT    BytesInWideCharString,
  [in, optional]  LPSTR  MultiByteString,
  [in]            INT    BytesInMultiByteString
);

Parâmetros

[in] CodePage

Especifica a página de código a ser usada para executar a tradução.

[out, optional] WideCharString

Ponteiro para o buffer no qual a cadeia de caracteres traduzida é copiada.

[in] BytesInWideCharString

Especifica o tamanho, em bytes, de WideCharString. Se WideCharString não for grande o suficiente para conter a tradução, EngMultiByteToWideChar truncará a cadeia de caracteres e não relatará um erro.

[in, optional] MultiByteString

Ponteiro para o buffer que contém a cadeia de caracteres multibyte a ser traduzida.

[in] BytesInMultiByteString

Especifica o número de bytes em MultiByteString.

Retornar valor

A função EngMultiByteToWideChar retornará o número de bytes convertidos em forma de caractere largo, se tiver êxito. Caso contrário, a função retornará -1.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Universal
Cabeçalho winddi.h (inclua Winddi.h)
Biblioteca Win32k.lib
DLL Win32k.sys

Confira também

EngUnicodeToMultiByteN

EngWideCharToMultiByte