Função RtlMultiByteToUnicodeSize (ntifs.h)

A rotina RtlMultiByteToUnicodeSize determina o número de bytes necessários para armazenar a tradução Unicode para a cadeia de caracteres de origem especificada. Supõe-se que a tradução use a ACP (página de código ANSI) do sistema atual. A cadeia de caracteres de origem não é necessariamente de um conjunto de caracteres multibyte.

Sintaxe

NTSYSAPI NTSTATUS RtlMultiByteToUnicodeSize(
  [out] PULONG     BytesInUnicodeString,
  [in]  const CHAR *MultiByteString,
  [in]  ULONG      BytesInMultiByteString
);

Parâmetros

[out] BytesInUnicodeString

Ponteiro para uma variável alocada pelo chamador que recebe o número de bytes necessários para armazenar a cadeia de caracteres traduzida.

[in] MultiByteString

Ponteiro para a cadeia de caracteres de origem para a qual o comprimento Unicode deve ser calculado.

[in] BytesInMultiByteString

Comprimento, em bytes, da cadeia de caracteres de origem.

Retornar valor

RtlMultiByteToUnicodeSize retorna STATUS_SUCCESS.

Comentários

RtlMultiByteToUnicodeSize pode ser chamado para determinar a quantidade de memória a ser alocada ou, possivelmente, o valor a ser especificado para MaxBytesInUnicodeString, antes de converter uma cadeia de caracteres multibyte em Unicode com RtlMultiByteToUnicodeN. O valor retornado não inclui espaço para um terminador NULL para a cadeia de caracteres Unicode.

Assim como RtlMultiByteToUnicodeN, RtlMultiByteToUnicodeSize dá suporte apenas a caracteres Unicode pré-compilados mapeados para a página de código ANSI do sistema atual instalada na inicialização do sistema.

Para obter informações sobre outras rotinas de manipulação de cadeia de caracteres, consulte Rotinas da RTL (Biblioteca em Tempo de Execução).

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

Confira também

RtlMultiByteToUnicodeN

RtlUnicodeToMultiByteSize