Función RtlUnicodeToMultiByteSize (winternl.h)

Determina cuántos bytes se necesitan para representar una cadena Unicode como una cadena ANSI.

Sintaxis

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

Parámetros

[out] BytesInMultiByteString

Devuelve el número de bytes para el equivalente ANSI de la cadena Unicode a la que apunta UnicodeString. Este número no incluye el carácter NULL de terminación.

[in] UnicodeString

Cadena de origen Unicode para la que se calcula la longitud ANSI.

[in] BytesInUnicodeString

Número de bytes de la cadena a la que apunta UnicodeString.

Valor devuelto

Código devuelto	Descripción
STATUS_SUCCESS	El recuento se realizó correctamente. Los distintos valores NTSTATUS se definen en NTSTATUS. H, que se distribuye con el DDK de Windows.

Comentarios

Se recomienda usar WideCharToMultiByte en lugar de RtlUnicodeToMultiByteSize. Cuando su parámetro cbMultiByte se establece en cero, la función WideCharToMultiByte devuelve el número de bytes necesarios para el búfer.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winternl.h
Library	ntdll.lib
Archivo DLL	ntdll.dll