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 |