Fonction RtlInitUTF8StringEx (ntifs.h)
RtlInitUTF8StringEx initialise une chaîne comptée de caractères UTF-8.
Syntaxe
NTSYSAPI NTSTATUS RtlInitUTF8StringEx(
PUTF8_STRING DestinationString,
__drv_aliasesMem PCSZ SourceString
);
Paramètres
DestinationString
Pointeur vers la structure UTF8_STRING à initialiser. Le fichier d’en-tête ntdef.h définit cette structure comme identique à la structure ANSI_STRING .
SourceString
Pointeur vers une chaîne de caractères terminée par null. SourceString est utilisé pour initialiser la chaîne comptée vers laquelle DestinationString pointe.
Valeur retournée
RtlInitUTF8StringEx retourne STATUS_NAME_TOO_LONG si sourceString est trop long. Sinon, cette routine retourne STATUS_SUCCESS.
Remarques
RtlInitUTF8StringEx définit les membres de la structure UTF8_STRING vers laquelle DestinationString pointe comme suit :
Copie la valeur de pointeur de SourceString dans le membre Buffer .
Définit le membre Length sur la longueur, en octets, de la chaîne source, à l’exclusion de la valeur null de fin.
Définit le membre MaximumLength sur la longueur, en octets, de la chaîne source, y compris la valeur null de fin.
Si SourceString a la valeur NULL, Length et MaximumLength sont tous deux définis sur zéro.
RtlInitStringEx ne modifie pas la chaîne source pointée par SourceString.
Les appelants de RtlInitStringEx peuvent s’exécuter sur IRQL <= DISPATCH_LEVEL si la mémoire tampon DestinationString n’est pas modifiable. En règle générale, les appelants s’exécutent à IRQL = PASSIVE_LEVEL, car la plupart des autres routines rtlXxxString ne peuvent pas être appelées au PASSIVE_LEVEL IRQL > .
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 10, version 2004 |
En-tête | ntifs.h |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour