Fonction RtlDowncaseUnicodeString (ntifs.h)

  • Article

La routine RtlDowncaseUnicodeString convertit la chaîne source Unicode spécifiée en minuscules. La traduction est conforme aux informations de paramètres régionaux système actuelles.

Syntaxe

NTSYSAPI NTSTATUS RtlDowncaseUnicodeString(
       PUNICODE_STRING  DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

Paramètres

DestinationString

Pointeur vers une mémoire tampon allouée à l’appelant pour recevoir la chaîne Unicode convertie. Si AllocateDestinationString a la valeur FALSE, l’appelant doit également allouer une mémoire tampon pour que le membre Buffer de DestinationString contienne les données Unicode. Si AllocateDestinationString a la valeur TRUE, RtlDowncaseUnicodeString alloue une mémoire tampon suffisamment grande pour contenir la chaîne, lui transmet un pointeur dans Buffer et met à jour les membres de longueur et de longueur maximale de DestinationString en conséquence.

[in] SourceString

Pointeur vers la chaîne Unicode source à convertir en minuscules.

[in] AllocateDestinationString

Définissez sur TRUE si RtlDowncaseUnicodeString doit allouer l’espace de mémoire tampon pour destinationString, false dans le cas contraire. Si ce paramètre a la valeur TRUE, l’appelant est chargé de libérer la mémoire tampon quand elle n’est plus nécessaire en appelant RtlFreeUnicodeString.

Valeur retournée

Si l’opération réussit, RtlDowncaseUnicodeString retourne STATUS_SUCCESS. Sinon, aucun stockage n’a été alloué et aucune conversion n’a été effectuée.

Remarques

Si l’appelant définit AllocateDestinationString sur TRUE, RtlDowncaseUnicodeString remplace le membre Buffer de DestinationString par un pointeur vers la mémoire tampon qu’il alloue. L’ancienne valeur peut être remplacée même lorsque la routine retourne une erreur status code.

RtlDowncaseUnicodeString ne modifie pas la chaîne source.

Pour plus d’informations sur les autres routines de gestion de chaînes, consultez Routines de la bibliothèque d’exécution (RTL).

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête ntifs.h (include Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Voir aussi

RtlFreeUnicodeString

RtlUpcaseUnicodeString

UNICODE_STRING