Função RtlInitUTF8StringEx (wdm.h)
A rotina RtlInitUTF8StringEx inicializa uma cadeia de caracteres contada de caracteres UTF-8.
Sintaxe
NTSYSAPI NTSTATUS RtlInitUTF8StringEx(
PUTF8_STRING DestinationString,
__drv_aliasesMem PCSZ SourceString
);
Parâmetros
DestinationString
Um ponteiro para a estrutura UTF8_STRING a ser inicializada. O arquivo de cabeçalho Ntdef.h define essa estrutura como idêntica à estrutura STRING .
SourceString
Um ponteiro para uma cadeia de caracteres terminada em nulo. Essa cadeia de caracteres é usada para inicializar a cadeia de caracteres contada apontada por DestinationString.
Retornar valor
Retorna STATUS_NAME_TOO_LONG se SourceString for muito longo. Caso contrário, essa rotina retornará STATUS_SUCCESS.
Comentários
A rotina copia o valor do ponteiro SourceString para o membro Buffer da estrutura UTF8_STRING apontada por DestinationString. O membro Length dessa estrutura é definido como o comprimento, em bytes, da cadeia de caracteres de origem, excluindo o nulo de terminação. O membro MaximumLength da estrutura é definido como o comprimento, em bytes, da cadeia de caracteres de origem, incluindo o nulo de terminação. Se SourceString for NULL, Length e MaximumLength serão definidos como zero.
RtlInitUTF8StringEx não altera a cadeia de caracteres de origem apontada por SourceString.
Os chamadores de RtlInitUTF8StringEx poderão ser executados em IRQL <= DISPATCH_LEVEL se o buffer DestinationString não for pageable. Normalmente, os chamadores são executados em IRQL = PASSIVE_LEVEL porque a maioria das outras rotinas rtlxxxstring não podem ser chamadas em PASSIVE_LEVEL IRQL > .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10, versão 2004 |
| Cabeçalho | wdm.h |
| IRQL | <= DISPATCH_LEVEL |