Compartir a través de


Función RtlCreateUnicodeString (ntifs.h)

La rutina RtlCreateUnicodeString crea una nueva cadena Unicode con recuento.

Sintaxis

NTSYSAPI BOOLEAN RtlCreateUnicodeString(
  [out] PUNICODE_STRING DestinationString,
  [in]  PCWSTR          SourceString
);

Parámetros

[out] DestinationString

Puntero a la cadena Unicode recién asignada e inicializada.

[in] SourceString

Puntero a una cadena Unicode terminada en null con la que inicializar la nueva cadena.

Valor devuelto

RtlCreateUnicodeString devuelve TRUE si la cadena Unicode se creó correctamente; en caso contrario, FALSE.

Comentarios

DestinationString se asigna desde el grupo paginado. El autor de la llamada es responsable de liberar DestinationString llamando a RtlFreeUnicodeString.

Para obtener información sobre otras rutinas de control de cadenas, consulte las funciones de manipulación de cadenas en rutinas de la biblioteca en tiempo de ejecución (RTL).

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000
Plataforma de destino Universal
Encabezado ntifs.h (incluya Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuario)
IRQL PASSIVE_LEVEL

Consulte también

RtlFreeUnicodeString

UNICODE_STRING