Share via

Função RtlUnicodeToMultiByteSize (winternl.h)

  • Artigo

Determina quantos bytes são necessários para representar uma cadeia de caracteres Unicode como uma cadeia de caracteres ANSI.

Sintaxe

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

Parâmetros

[out] BytesInMultiByteString

Retorna o número de bytes para o equivalente ANSI da cadeia de caracteres Unicode apontada por UnicodeString. Esse número não inclui o caractere NULL de terminação.

[in] UnicodeString

A cadeia de caracteres de origem Unicode para a qual o comprimento ANSI é calculado.

[in] BytesInUnicodeString

O número de bytes na cadeia de caracteres apontada por UnicodeString.

Retornar valor

Código de retorno Descrição
STATUS_SUCCESS
 A contagem foi bem-sucedida. Os vários valores NTSTATUS são definidos em NTSTATUS. H, que é distribuído com o DDK do Windows.

Comentários

É recomendável que você use WideCharToMultiByte em vez de RtlUnicodeToMultiByteSize. Quando o parâmetro cbMultiByte é definido como zero, a função WideCharToMultiByte retorna o número de bytes necessários para o buffer.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winternl.h
Biblioteca ntdll.lib
DLL ntdll.dll