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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10, version 2004 |
| En-tête | wdm.h |
| IRQL | <= DISPATCH_LEVEL |