Funzione RtlUnicodeStringCopy (ntstrsafe.h)
La funzione RtlUnicodeStringCopy copia una stringa da una struttura UNICODE_STRING a un'altra.
Sintassi
NTSTRSAFEDDI RtlUnicodeStringCopy(
[out] PUNICODE_STRING DestinationString,
[in] PCUNICODE_STRING SourceString
);
Parametri
[out] DestinationString
Puntatore a una struttura UNICODE_STRING. La stringa di origine viene copiata nella stringa di destinazione. Il numero massimo di byte nel buffer stringa della struttura è NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).
[in] SourceString
Puntatore a una struttura UNICODE_STRING. Questa struttura include un buffer che contiene la stringa di origine. Questa stringa verrà copiata nella stringa di destinazione. Il numero massimo di byte nel buffer stringa della struttura è NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).
Valore restituito
RtlUnicodeStringCopy restituisce uno dei valori NTSTATUS seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Questo esito positivo stato indica che i dati di origine erano presenti, la stringa è stata copiata senza troncamento e il buffer di destinazione risultante viene terminato con null. |
|
Questo avviso stato indica che l'operazione di copia non è stata completata a causa di spazio buffer insufficiente. Il buffer di destinazione contiene una versione troncata della stringa di origine. |
|
Questo errore stato indica che la funzione ha ricevuto un parametro di input non valido. Per altre informazioni, vedere l'elenco seguente. |
RtlUnicodeStringCopy restituisce il valore STATUS_INVALID_PARAMETER quando si verifica una delle operazioni seguenti:
- Il contenuto di una struttura di UNICODE_STRING non è valido.
- Il buffer di destinazione è già pieno.
- Un puntatore al buffer è NULL.
- La lunghezza del buffer di destinazione è zero, ma è presente una stringa di origine di lunghezza diversa da zero.
Osservazioni
La funzione RtlUnicodeStringCopy usa le dimensioni del buffer di destinazione per assicurarsi che l'operazione di copia non scriva oltre la fine del buffer. Se la stringa deve essere troncata alla fine del buffer di destinazione, la funzione non termina la stringa risultante con un carattere Null.
Se le stringhe di origine e di destinazione si sovrappongono, il comportamento della funzione non è definito.
I puntatori SourceString e DestinationString non possono essere NULL. Se è necessario gestire valori puntatore NULL, usare la funzione RtlUnicodeStringCopyEx.
Per altre informazioni sulle funzioni di stringa sicura, vedere Using Safe String Functions.For more information about the safe string functions, see Using Safe String Functions.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows XP con Service Pack 1 (SP1) e versioni successive di Windows. |
| piattaforma di destinazione | Desktop |
| intestazione | ntstrsafe.h (include Ntstrsafe.h) |
| libreria | Ntstrsafe.lib |
| IRQL | Qualsiasi se le stringhe modificate sono sempre residenti in memoria, altrimenti PASSIVE_LEVEL |