Función RtlAppendUnicodeToString (wdm.h)

La rutina RtlAppendUnicodeToString concatena la cadena Unicode proporcionada en una cadena Unicode almacenada en búfer.

Sintaxis

NTSYSAPI NTSTATUS RtlAppendUnicodeToString(
  [in, out]      PUNICODE_STRING Destination,
  [in, optional] PCWSTR          Source
);

Parámetros

[in, out] Destination

Puntero a la cadena almacenada en búfer.

[in, optional] Source

Puntero a la cadena terminada en null que se va a anexar a la cadena de destino .

Valor devuelto

RtlAppendUnicodeToString puede devolver una de las siguientes opciones:

Código devuelto	Descripción
STATUS_SUCCESS	La cadena de origen se anexó correctamente a la cadena de destino y la longitud de la cadena de destino se actualizó para incluir los bytes anexados.
STATUS_BUFFER_TOO_SMALL	El búfer de cadena de destino es demasiado pequeño para permitir que se anexe la cadena de origen, por lo que la longitud de la cadena de destino no se actualiza y no se cambia el contenido del búfer de cadena de destino.

Comentarios

RtlAppendUnicodeToString anexa la cadena de origen al final de la cadena de destino.

Si el búfer de destino no es lo suficientemente grande como para contener la cadena que daría lugar a la concatenación de las cadenas de origen y de destino (sin incluir el carácter null que finaliza la cadena de origen), la rutina devuelve STATUS_BUFFER_TOO_SMALL y deja sin cambios la cadena de destino.

El búfer de destino debe estar residente si el autor de la llamada se ejecuta en IRQL >= DISPATCH_LEVEL.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 2000.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuario)
IRQL	vea la sección Comentarios.

Consulte también

RtlAppendUnicodeStringToString