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

Consulte también

RtlMultiByteToUnicodeN

RtlUnicodeToMultiByteSize