Função RtlCreateUnicodeString (ntifs.h)

  • Artigo

A rotina RtlCreateUnicodeString cria uma nova cadeia de caracteres Unicode contada.

Sintaxe

NTSYSAPI BOOLEAN RtlCreateUnicodeString(
  [out] PUNICODE_STRING DestinationString,
  [in]  PCWSTR          SourceString
);

Parâmetros

[out] DestinationString

Ponteiro para a cadeia de caracteres Unicode recém-alocada e inicializada.

[in] SourceString

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo com a qual inicializar a nova cadeia de caracteres.

Retornar valor

RtlCreateUnicodeString retornará TRUE se a cadeia de caracteres Unicode tiver sido criada com êxito, caso contrário, FALSE .

Comentários

O DestinationString é alocado do pool de páginas. O chamador é responsável por liberar DestinationString chamando RtlFreeUnicodeString.

Para obter informações sobre outras rotinas de tratamento de cadeia de caracteres, consulte as funções de manipulação de cadeia de caracteres em Rotinas rtl (biblioteca em tempo de execução).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuário)
IRQL PASSIVE_LEVEL

Confira também

RtlFreeUnicodeString

UNICODE_STRING