Partager via


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

ANSI_STRING