Función RtlAppendUnicodeToString (wdm.h)

  • Artículo

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