RtlMultiByteToUnicodeSize, fonction (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 codes ANSI (ACP) système actuelle. 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 par 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 de retour
RtlMultiByteToUnicodeSize retourne STATUS_SUCCESS.
Remarques
RtlMultiByteToUnicodeSize peut être appelée 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 un terminateur NULL pour la chaîne Unicode.
Comme RtlMultiByteToUnicodeN, RtlMultiByteToUnicodeSize 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).
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |