Función RtlMultiByteToUnicodeSize (ntifs.h)
La rutina RtlMultiByteToUnicodeSize determina el número de bytes necesarios para almacenar la traducción Unicode para la cadena de origen especificada. Se supone que la traducción usa la página de códigos ANSI (ACP) del sistema actual. La cadena de origen no es necesariamente de un juego de caracteres multibyte.
Sintaxis
NTSYSAPI NTSTATUS RtlMultiByteToUnicodeSize(
[out] PULONG BytesInUnicodeString,
[in] const CHAR *MultiByteString,
[in] ULONG BytesInMultiByteString
);
Parámetros
[out] BytesInUnicodeString
Puntero a una variable asignada por el autor de la llamada que recibe el número de bytes necesarios para almacenar la cadena traducida.
[in] MultiByteString
Puntero a la cadena de origen para la que se va a calcular la longitud Unicode.
[in] BytesInMultiByteString
Longitud, en bytes, de la cadena de origen.
Valor devuelto
RtlMultiByteToUnicodeSize devuelve STATUS_SUCCESS.
Comentarios
Se puede llamar a RtlMultiByteToUnicodeSize para determinar la cantidad de memoria que se va a asignar, o posiblemente, el valor que se va a especificar para MaxBytesInUnicodeString, antes de traducir una cadena multibyte a Unicode con RtlMultiByteToUnicodeN. El valor devuelto no incluye espacio para un terminador NULL para la cadena Unicode.
Al igual que RtlMultiByteToUnicodeN, RtlMultiByteToUnicodeSize solo admite caracteres Unicode precomponidos asignados a la página de códigos ANSI del sistema actual instalada en el arranque del sistema.
Para obtener información sobre otras rutinas de control de cadenas, vea Rutinas de la biblioteca en tiempo de ejecución (RTL).
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluya Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |