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 étant 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 DestinationStr ing pointe vers.

Valeur de retour

RtlInitUTF8StringEx retourne STATUS_NAME_TOO_LONG si la SourceString est trop longue. Sinon, cette routine retourne STATUS_SUCCESS.

Remarques

RtlInitUTF8StringEx définit les membres de la structure UTF8_STRING qui DestinationString pointe comme suit :

• Copie la valeur du pointeur de sourceString dans le membre tampon.

• 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 est 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 à l'<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 RtlXxxroutines de chaîne ne peuvent pas être appelées à l'> PASSIVE_LEVEL IRQL.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 2004
d’en-tête	ntifs.h

Voir aussi

ANSI_STRING