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) |