Função RtlUnicodeToMultiByteSize (ntifs.h)

Artigo
02/29/2024

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

Sintaxe

NTSYSAPI NTSTATUS RtlUnicodeToMultiByteSize(
  [out] PULONG BytesInMultiByteString,
  [in]  PCWCH  UnicodeString,
  [in]  ULONG  BytesInUnicodeString
);

Parâmetros

[out] BytesInMultiByteString

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] UnicodeString

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

[in] BytesInUnicodeString

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

Retornar valor

RtlUnicodeToMultiByteSize retorna STATUS_SUCCESS.

Comentários

RtlUnicodeToMultiByteSize pode ser chamado para determinar quanta memória alocar ou possivelmente o valor a ser especificado para MaxBytesInMultiByteString, antes de traduzir uma cadeia de caracteres Unicode para ANSI com RtlUnicodeToMultiByteN ou RtlUpcaseUnicodeToMultiByteN. O valor retornado não inclui espaço para um terminador NULL para a cadeia de caracteres ANSI.

Assim como RtlUnicodeToMultiByteN, RtlUnicodeToMultiByteSize 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 tratamento de cadeia de caracteres, consulte Rotinas rtl (biblioteca em tempo de execução).