Compartilhar via


Função RtlUpcaseUnicodeString (ntddk.h)

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 pelo chamador para a cadeia de caracteres Unicode convertida.

[in] SourceString

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

[in] AllocateDestinationString

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

Retornar valor

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
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Universal
Cabeçalho ntddk.h (inclua Ntddk.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuário)
IRQL <= APC_LEVEL

Confira também

RtlFreeUnicodeString

RtlUpcaseUnicodeChar