Función RtlMultiByteToUnicodeSize (ntifs.h)
La rutina de 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 del sistema actual (ACP). 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.
Observaciones
se puede llamar a rtlMultiByteToUnicodeSize para determinar la cantidad de memoria que se va a asignar, o posiblemente, el valor que se debe 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 precomposificados que se asignan 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, consulte rutinas de Run-Time Library (RTL).
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | ntifs.h (incluya Ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | < DISPATCH_LEVEL |