Fonction RtlInitStringEx (ntifs.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 vers 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

Voir aussi

ANSI_STRING