Função RtlUnicodeToMultiByteN (ntifs.h)

A rotina RtlUnicodeToMultiByteN converte a cadeia de caracteres Unicode especificada em uma nova cadeia de caracteres, usando a ACP (página de código ANSI) do sistema atual. A cadeia de caracteres traduzida não é necessariamente de um conjunto de caracteres multibyte.

Sintaxe

NTSYSAPI NTSTATUS RtlUnicodeToMultiByteN(
  [out]           PCHAR  MultiByteString,
  [in]            ULONG  MaxBytesInMultiByteString,
  [out, optional] PULONG BytesInMultiByteString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

Parâmetros

[out] MultiByteString

Ponteiro para um buffer alocado pelo chamador para receber a cadeia de caracteres traduzida. O buffer MultiByteString não deve se sobrepor ao buffer UnicodeString .

[in] MaxBytesInMultiByteString

Número máximo de bytes a serem gravados em MultiByteString. Se esse valor fizer com que a cadeia de caracteres traduzida seja truncada, RtlUnicodeToMultiByteN não retornará um erro status.

[out, optional] BytesInMultiByteString

Ponteiro para uma variável alocada pelo chamador que recebe o comprimento, em bytes, da cadeia de caracteres traduzida. Esse parâmetro é opcional e pode ser NULL.

[in] UnicodeString

Ponteiro para a cadeia de caracteres de origem Unicode a ser traduzida.

[in] BytesInUnicodeString

Tamanho, em bytes, da cadeia de caracteres em UnicodeString.

Retornar valor

RtlUnicodeToMultiByteN retorna STATUS_SUCCESS.

Comentários

RtlUnicodeToMultiByteN converte a cadeia de caracteres Unicode fornecida usando a página de código ANSI do sistema atual que foi instalada no momento da inicialização do sistema.

Embora BytesInMultiByteString seja opcional e possa ser NULL, os chamadores devem fornecer armazenamento para ele, pois o comprimento recebido pode ser usado para determinar se a conversão foi bem-sucedida.

Essa rotina não modifica a cadeia de caracteres de origem. Ele retornará uma cadeia de caracteres multibyte terminada em nulo se o BytesInUnicodeString especificado incluir um terminador NULL e se o MaxBytesInMultiByteString especificado não causar truncamento.

Assim como RtlUnicodeToMultiByteSize, RtlUnicodeToMultiByteN 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

Confira também

RtlMultiByteToUnicodeN

RtlUnicodeToMultiByteSize

RtlUpcaseUnicodeToMultiByteN