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 |