Fonction RtlInitStringEx (wdm.h)
La routine RtlInitStringEx initialise une chaîne comptée de caractères 8 bits.
Syntaxe
NTSYSAPI NTSTATUS RtlInitStringEx(
[out] PSTRING DestinationString,
[in, optional] __drv_aliasesMem PCSZ SourceString
);
Paramètres
[out] DestinationString
Pointeur vers la structure STRING à initialiser. Le fichier d’en-tête Ntdef.h définit cette structure comme identique à la structure ANSI_STRING .
[in, optional] 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
Cette routine initialise une chaîne de caractères comptée.
La routine copie la valeur du pointeur SourceString dans le membre Buffer de la structure 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.
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 | Disponible à partir de Windows 10. |
| Plateforme cible | Universal |
| En-tête | wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Consultez la section Notes. |