RtlUpcaseUnicodeToMultiByteN, fonction (ntifs.h)

Article
02/07/2025

La routine RtlUpcaseUnicodeToMultiByteN convertit la chaîne Unicode spécifiée en 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 par l’appelant pour recevoir la chaîne traduite.

[in] MaxBytesInMultiByteString

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

[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 à UnicodeString .

Valeur de retour

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 moment du 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 le BytesInUnicodeString donné incluait un terminateur NULL et si le MaxBytesInMultiByteString donné n’a pas généré de troncation.

Pour plus d’informations sur les autres routines de gestion des chaînes, consultez Run-Time Routines de bibliothèque (RTL).