Função RtlCreateUnicodeString (ntifs.h)
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.
Valor de retorno
RtlCreateUnicodeString retornará verdadeiro se a cadeia de caracteres Unicode tiver sido criada com êxito, FALSE caso contrário.
Observações
O DestinationString é alocado do pool de páginas. O chamador é responsável por liberar o DestinationString chamando RtlFreeUnicodeString.
Para obter informações sobre outras rotinas de tratamento de cadeias de caracteres, consulte as funções de manipulação de cadeia de caracteres em rotinas de rtl (biblioteca de Run-Time).
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 |
| da Plataforma de Destino | Universal |
| cabeçalho | ntifs.h (inclua Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuário) |
| IRQL | PASSIVE_LEVEL |