Función RtlUnicodeStringToAnsiString (wdm.h)

La rutina RtlUnicodeStringToAnsiString convierte una cadena Unicode determinada en una cadena ANSI.

Sintaxis

NTSYSAPI NTSTATUS RtlUnicodeStringToAnsiString(
  [in, out] PANSI_STRING     DestinationString,
  [in]      PCUNICODE_STRING SourceString,
  [in]      BOOLEAN          AllocateDestinationString
);

Parámetros

[in, out] DestinationString

Puntero a una estructura de ANSI_STRING para contener la cadena ANSI convertida. Si AllocateDestinationString es TRUE, la rutina asigna un nuevo búfer para contener los datos de cadena y actualiza el miembro buffer de DestinationString para que apunte al nuevo búfer. De lo contrario, la rutina usa el búfer especificado actualmente para contener la cadena.

[in] SourceString

Puntero a la cadena de origen Unicode que se va a convertir en ANSI.

[in] AllocateDestinationString

TRUE si esta rutina es asignar el espacio de búfer para DestinationString. Si es así, el búfer debe desasignarse llamando a RtlFreeAnsiString.

Valor devuelto

Si la conversión se realiza correctamente, RtlUnicodeStringToAnsiString devuelve STATUS_SUCCESS. De lo contrario, no se asignó ningún almacenamiento y no se realizó ninguna conversión.

Comentarios

La traducción se realiza de acuerdo con la información actual de configuración regional del sistema.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 2000.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Consulte también

ANSI_STRING

RtlAnsiStringToUnicodeString

RtlFreeAnsiString

UNICODE_STRING