Función RtlUnicodeStringToAnsiString (winternl.h)

  • Artículo

Convierte la cadena de origen Unicode especificada en una cadena ANSI.

Sintaxis

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

Parámetros

[in, out] DestinationString

Puntero a una estructura ANSI_STRING que contiene 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

Estructura UNICODE_STRING que contiene la cadena de origen que se va a convertir en ANSI.

[in] AllocateDestinationString

Controla la asignación del espacio de búfer para DestinationString.

TRUE

Se asigna espacio de búfer para DestinationString. Si se establece en TRUE, el búfer debe desasignarse mediante RtlFreeAnsiString.

FALSE

No se asigna espacio de búfer para DestinationString.

Valor devuelto

Los distintos valores NTSTATUS se definen en NTSTATUS. H, que se distribuye con el DDK.

Código devuelto Descripción
STATUS_SUCCESS
 La cadena Unicode se convirtió en ANSI. De lo contrario, no se asignó ningún almacenamiento y no se realizó ninguna conversión.

Comentarios

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

Dado que no hay ninguna biblioteca de importación para esta función, debe usar GetProcAddress.

Requisitos

Requisito Value
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; NtosKrnl.exe