Funzione RtlCopyUnicodeString (wdm.h)
La routine RtlCopyUnicodeString copia una stringa di origine in una stringa di destinazione.
Sintassi
NTSYSAPI VOID RtlCopyUnicodeString(
[in, out] PUNICODE_STRING DestinationString,
[in, optional] PCUNICODE_STRING SourceString
);
Parametri
[in, out] DestinationString
Puntatore al buffer della stringa di destinazione. Questo parametro punta a una struttura UNICODE_STRING .
[in, optional] SourceString
Puntatore al buffer della stringa di origine. Questo parametro punta a una struttura UNICODE_STRING .
Valore restituito
nessuno
Osservazioni
Se SourceString è NULL, questa routine imposta il campo Length della struttura a cui punta DestinationString su zero.
Questa routine non modifica i campi MaximumLength e Buffer della struttura a cui punta destinationString.
Il numero di byte copiati dalla stringa di origine è la lunghezza della stringa di origine (specificata dal membro Length della struttura puntata da SourceString) o la lunghezza massima della stringa di destinazione (specificata dal membro MaximumLength della struttura puntata a DestinationString), che tuttavia è più piccola.
Il chiamante deve inizializzare correttamente tutti i membri della struttura a cui punta DestinationString prima di chiamare RtlCopyUnicodeString. Impossibile inizializzare il membro Length o MaximumLength prima di chiamare questa routine può causare un overrun del buffer.
I buffer DestinationString e SourceString devono essere residenti se il chiamante è in esecuzione in IRQL >= DISPATCH_LEVEL.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe (modalità kernel); Ntdll.dll (modalità utente) |
| IRQL | Qualsiasi livello (vedere la sezione Osservazioni) |