Función RtlUnicodeToMultiByteSize (ntifs.h)

Artículo
08/07/2023

La rutina RtlUnicodeToMultiByteSize determina el número de bytes necesarios para almacenar la traducción multibyte para la cadena Unicode especificada. Se supone que la traducción usa la página de códigos ANSI (ACP) del sistema actual.

Sintaxis

NTSYSAPI NTSTATUS RtlUnicodeToMultiByteSize(
  [out] PULONG BytesInMultiByteString,
  [in]  PCWCH  UnicodeString,
  [in]  ULONG  BytesInUnicodeString
);

Parámetros

[out] BytesInMultiByteString

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] UnicodeString

Puntero a la cadena Unicode para la que se va a calcular la longitud multibyte.

[in] BytesInUnicodeString

Longitud, en bytes, de la cadena de origen.

Valor devuelto

RtlUnicodeToMultiByteSize devuelve STATUS_SUCCESS.

Comentarios

Se puede llamar a RtlUnicodeToMultiByteSize para determinar la cantidad de memoria que se va a asignar, o posiblemente el valor que se va a especificar para MaxBytesInMultiByteString, antes de traducir una cadena Unicode a ANSI con RtlUnicodeToMultiByteN o RtlUpcaseUnicodeToMultiByteN. El valor devuelto no incluye espacio para un terminador NULL para la cadena ANSI.

Al igual que RtlUnicodeToMultiByteN, RtlUnicodeToMultiByteSize 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).