Função RtlDowncaseUnicodeString (ntifs.h)

  • Artigo

A rotina RtlDowncaseUnicodeString converte a cadeia de caracteres de origem Unicode especificada em minúsculas. A tradução está em conformidade com as informações atuais de localidade do sistema.

Sintaxe

NTSYSAPI NTSTATUS RtlDowncaseUnicodeString(
       PUNICODE_STRING  DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

Parâmetros

DestinationString

Ponteiro para um buffer alocado pelo chamador para receber a cadeia de caracteres Unicode convertida. Se AllocateDestinationString for FALSE, o chamador também deverá alocar um buffer para que o membro Buffer de DestinationString mantenha os dados Unicode. Se AllocateDestinationString for TRUE, RtlDowncaseUnicodeString alocará um buffer grande o suficiente para manter a cadeia de caracteres, passará um ponteiro para ele no Buffer e atualizará os membros de comprimento e comprimento máximo de DestinationString adequadamente.

[in] SourceString

Ponteiro para a cadeia de caracteres Unicode de origem a ser convertida em minúsculas.

[in] AllocateDestinationString

Defina como TRUE se RtlDowncaseUnicodeString deve alocar o espaço de buffer para DestinationString; caso contrário, FALSE . Se esse parâmetro for TRUE, o chamador será responsável por liberar o buffer quando ele não for mais necessário chamando RtlFreeUnicodeString.

Retornar valor

Se a operação for bem-sucedida, RtlDowncaseUnicodeString retornará STATUS_SUCCESS. Caso contrário, nenhum armazenamento foi alocado e nenhuma conversão foi feita.

Comentários

Se o chamador definir AllocateDestinationString como TRUE, RtlDowncaseUnicodeString substituirá o membro Buffer de DestinationString por um ponteiro para o buffer alocado. O valor antigo pode ser substituído mesmo quando a rotina retorna um erro status código.

RtlDowncaseUnicodeString não modifica a cadeia de caracteres de origem.

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

RtlFreeUnicodeString

RtlUpcaseUnicodeString

UNICODE_STRING