Fonction RtlUnicodeToMultiByteSize (ntifs.h)

Article
02/26/2024

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 code ANSI (ACP) du système actuel.

Syntaxe

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

Paramètres

[out] BytesInMultiByteString

Pointeur vers une variable allouée à 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 retournée

RtlUnicodeToMultiByteSize retourne STATUS_SUCCESS.

Remarques

RtlUnicodeToMultiByteSize peut être appelé 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 une terminaison NULL pour la chaîne ANSI.

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

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