Función RtlCreateUnicodeString (ntifs.h)

La rutina RtlCreateUnicodeStr ing 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, FALSE de lo contrario.

Observaciones

El DestinationString se asigna desde el grupo paginado. El autor de la llamada es responsable de liberar el destinationString de 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 Run-Time Library (RTL).

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000
de la plataforma de destino de	Universal
encabezado de	ntifs.h (incluya Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuario)
irQL	PASSIVE_LEVEL

Consulte también

RtlFreeUnicodeString

UNICODE_STRING