Función RtlAnsiStringToUnicodeString (winternl.h)

  • Artículo

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

Sintaxis

NTSTATUS RtlAnsiStringToUnicodeString(
  [in, out] PUNICODE_STRING DestinationString,
  [in]      PCANSI_STRING   SourceString,
  [in]      BOOLEAN         AllocateDestinationString
);

Parámetros

[in, out] DestinationString

Puntero a una estructura de UNICODE_STRING que contiene la cadena Unicode 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 estructura ANSI_STRING que contiene la cadena ANSI que se va a convertir en Unicode.

[in] AllocateDestinationString

Controla la asignación de espacio de búfer para la cadena de destino.

TRUE

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

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 de Windows.

Código devuelto Descripción
STATUS_SUCCESS
 La cadena ANSI se convirtió en Unicode. En caso de error, la rutina no asigna ninguna memoria.

Comentarios

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

Si el llamador establece AllocateDestinationString en TRUE, la rutina reemplaza el miembro Buffer de DestinationString por un puntero al búfer que asigna. El valor anterior se puede sobrescribir incluso cuando la rutina devuelve un código de estado de error.

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

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