Função RtlUpcaseUnicodeString (ntddk.h)

Artigo
02/07/2025

A rotina RtlUpcaseUnicodeString converte uma cópia da cadeia de caracteres de origem em maiúsculas e grava a cadeia de caracteres convertida no buffer de destino.

Sintaxe

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

Parâmetros

[in, out] DestinationString

Ponteiro para um buffer alocado por chamador para a cadeia de caracteres Unicode convertida.

[in] SourceString

Ponteiro para a cadeia de caracteres Unicode de origem a ser convertida em maiúscula.

[in] AllocateDestinationString

Especifica se RtlUpcaseUnicodeString é alocar o espaço de buffer para o DestinationString. Se isso acontecer, o buffer deverá ser desalocado chamando RtlFreeUnicodeString.

Valor de retorno

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 2000.
da Plataforma de Destino	Universal
cabeçalho	ntddk.h (inclua Ntddk.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuário)
IRQL	<= APC_LEVEL

Consulte também

rtlFreeUnicodeString

rtlUpcaseUnicodeChar

Compartilhar via