Función RtlUnicodeToMultiByteSize (ntifs.h)
La rutina de 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 del sistema actual (ACP).
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.
Observaciones
se puede llamar a la RtlUnicodeToMultiByteSize para determinar la cantidad de memoria que se va a asignar, o posiblemente el valor que se debe 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 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 |