Función RtlCopyUnicodeString (wdm.h)

La rutina RtlCopyUnicodeString copia una cadena de origen en una cadena de destino.

Sintaxis

NTSYSAPI VOID RtlCopyUnicodeString(
  [in, out]      PUNICODE_STRING  DestinationString,
  [in, optional] PCUNICODE_STRING SourceString
);

Parámetros

[in, out] DestinationString

Puntero al búfer de cadena de destino. Este parámetro apunta a una estructura de UNICODE_STRING .

[in, optional] SourceString

Puntero al búfer de cadena de origen. Este parámetro apunta a una estructura de UNICODE_STRING .

Valor devuelto

None

Observaciones

Si SourceString es NULL, esta rutina establece el campo Length de la estructura a la que apunta DestinationString en cero.

Esta rutina no modifica los campos MaximumLength y Buffer de la estructura a la que apunta DestinationString.

El número de bytes copiados de la cadena de origen es la longitud de la cadena de origen (especificada por el miembro Length de la estructura a la que apunta SourceString) o la longitud máxima de la cadena de destino (especificada por el miembro MaximumLength de la estructura a la que apunta DestinationString), lo que sea menor.

El llamador debe inicializar correctamente todos los miembros de la estructura a los que apunta DestinationString antes de llamar a RtlCopyUnicodeString. Si no se inicializa el miembro Length o MaximumLength antes de llamar a esta rutina, se puede producir una saturación del búfer.

Los búferes DestinationString y SourceString deben residir 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	Cualquier nivel (consulte la sección Comentarios)

Consulte también

RtlCopyString

UNICODE_STRING