RtlUnicodeToMultiByteSize, fonction (ntifs.h)

Article
02/07/2025

La routine RtlUnicodeToMultiByteSize détermine le nombre d’octets requis pour stocker la traduction multioctet pour la chaîne Unicode spécifiée. La traduction est supposée utiliser la page de codes ANSI (ACP) système actuelle.

Syntaxe

NTSYSAPI NTSTATUS RtlUnicodeToMultiByteSize(
  [out] PULONG BytesInMultiByteString,
  [in]  PCWCH  UnicodeString,
  [in]  ULONG  BytesInUnicodeString
);

Paramètres

[out] BytesInMultiByteString

Pointeur vers une variable allouée par l’appelant qui reçoit le nombre d’octets requis pour stocker la chaîne traduite.

[in] UnicodeString

Pointeur vers la chaîne Unicode pour laquelle la longueur multioctet doit être calculée.

[in] BytesInUnicodeString

Longueur, en octets, de la chaîne source.

Valeur de retour

RtlUnicodeToMultiByteSize retourne STATUS_SUCCESS.

Remarques

RtlUnicodeToMultiByteSize peut être appelée pour déterminer la quantité de mémoire à allouer, ou éventuellement la valeur à spécifier pour MaxBytesInMultiByteString, avant de traduire une chaîne Unicode en ANSI avec RtlUnicodeToMultiByteN ou RtlUpcaseUnicodeToMultiByteN. La valeur retournée n’inclut pas d’espace pour un terminateur NULL pour la chaîne ANSI.

Comme RtlUnicodeToMultiByteN, RtlUnicodeToMultiByteSize prend en charge uniquement les caractères Unicode précomposés mappés à la page de codes ANSI système actuelle installée au démarrage du système.

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