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