Fonction RtlMultiByteToUnicodeSize (ntifs.h)

La routine RtlMultiByteToUnicodeSize détermine le nombre d’octets requis pour stocker la traduction Unicode pour la chaîne source spécifiée. La traduction est supposée utiliser la page de code ANSI (ACP) du système actuel. La chaîne source ne provient pas nécessairement d’un jeu de caractères multioctets.

Syntaxe

NTSYSAPI NTSTATUS RtlMultiByteToUnicodeSize(
  [out] PULONG     BytesInUnicodeString,
  [in]  const CHAR *MultiByteString,
  [in]  ULONG      BytesInMultiByteString
);

Paramètres

[out] BytesInUnicodeString

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

[in] MultiByteString

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

[in] BytesInMultiByteString

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

Valeur retournée

RtlMultiByteToUnicodeSize retourne STATUS_SUCCESS.

Remarques

RtlMultiByteToUnicodeSize peut être appelé pour déterminer la quantité de mémoire à allouer, ou éventuellement la valeur à spécifier pour MaxBytesInUnicodeString, avant de traduire une chaîne multioctet en Unicode avec RtlMultiByteToUnicodeN. La valeur retournée n’inclut pas d’espace pour une terminaison NULL pour la chaîne Unicode.

Comme RtlMultiByteToUnicodeN, RtlMultiByteToUnicodeSize 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).

Configuration requise

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

Voir aussi

RtlMultiByteToUnicodeN

RtlUnicodeToMultiByteSize