Fonction RtlUpcaseUnicodeToMultiByteN (ntifs.h)

Article
02/26/2024

La routine RtlUpcaseUnicodeToMultiByteN traduit la chaîne Unicode spécifiée en une nouvelle chaîne de caractères majuscules, à l’aide de la page de codes ANSI (ACP) système actuelle. La chaîne traduite ne provient pas nécessairement d’un jeu de caractères multioctets.

Syntaxe

NTSYSAPI NTSTATUS RtlUpcaseUnicodeToMultiByteN(
  [out]           PCHAR  MultiByteString,
  [in]            ULONG  MaxBytesInMultiByteString,
  [out, optional] PULONG BytesInMultiByteString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

Paramètres

[out] MultiByteString

Pointeur vers une mémoire tampon allouée à l’appelant pour recevoir la chaîne traduite.

[in] MaxBytesInMultiByteString

Nombre maximal d’octets à écrire dans MultiByteString. Si cette valeur entraîne la troncation de la chaîne traduite, RtlUpcaseUnicodeToMultiByteN ne retourne pas d’erreur status.

[out, optional] BytesInMultiByteString

Pointeur vers une variable allouée par l’appelant qui reçoit la longueur, en octets, de la chaîne traduite. Ce paramètre peut être NULL.

[in] UnicodeString

Pointeur vers la chaîne source Unicode à traduire.

[in] BytesInUnicodeString

Taille, en octets, de la chaîne dans UnicodeString.

Valeur retournée

RtlUpcaseUnicodeToMultiByteN retourne STATUS_SUCCESS.

Remarques

RtlUpcaseUnicodeToMultiByteN traduit la chaîne Unicode donnée à l’aide de la page de codes ANSI système actuelle installée au démarrage du système et convertit la chaîne traduite en majuscules.

Cette routine ne modifie pas la chaîne source. Elle retourne une chaîne ANSI terminée par NULL si l’objet BytesInUnicodeString donné incluait un terminateur NULL et si la valeur MaxBytesInMultiByteString donnée n’a pas causé de troncation.

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