Fonction RtlInitUTF8StringEx (wdm.h)

La routine 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 STRING .

SourceString

Pointeur vers une chaîne de caractères terminée par null. Cette chaîne est utilisée pour initialiser la chaîne comptée pointée par DestinationString.

Valeur retournée

Retourne STATUS_NAME_TOO_LONG si sourceString est trop long. Sinon, cette routine retourne STATUS_SUCCESS.

Remarques

La routine copie la valeur du pointeur SourceString dans le membre Buffer de la structure UTF8_STRING pointée par DestinationString. Le membre Length de cette structure est défini sur la longueur, en octets, de la chaîne source, à l’exclusion de la valeur Null de fin. Le membre MaximumLength de la structure est défini 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.

RtlInitUTF8StringEx ne modifie pas la chaîne source pointée vers sourceString.

Les appelants de RtlInitUTF8StringEx peuvent s’exécuter à IRQL <= DISPATCH_LEVEL si la mémoire tampon DestinationString est non 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

Voir aussi

RtlInitAnsiString