Funzione RtlUnicodeStringCchCopyN (ntstrsafe.h)
La funzione RtlUnicodeStringCchCopyN copia una stringa da una struttura UNICODE_STRING a un'altra limitando le dimensioni della stringa copiata.
Sintassi
NTSTRSAFEDDI RtlUnicodeStringCchCopyN(
[out] PUNICODE_STRING DestinationString,
[in] PCUNICODE_STRING SourceString,
[in] size_t cchToCopy
);
Parametri
[out] DestinationString
Puntatore a una struttura UNICODE_STRING che riceve la stringa copiata. Stringa a cui punta la struttura UNICODE_STRING del UNICODE_STRING parametro SourceString nel buffer a cui punta il parametro DestinationString. Il numero massimo di caratteri nel buffer stringa della struttura è NTSTRSAFE_UNICODE_STRING_MAX_CCH.
[in] SourceString
Puntatore a una struttura UNICODE_STRING contenente la stringa da copiare. Il numero massimo di caratteri nel buffer stringa della struttura è NTSTRSAFE_UNICODE_STRING_MAX_CCH.
[in] cchToCopy
Numero di caratteri da copiare dall'origine alla destinazione.
Valore restituito
RtlUnicodeStringCchCopyN restituisce uno dei valori NTSTATUS seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Questo stato di esito positivo indica che i dati di origine erano presenti, la stringa è stata copiata senza troncamento e il buffer di destinazione risultante viene terminato con valore Null. |
|
Questo stato di avviso indica che l'operazione di copia non è stata completata a causa di spazio buffer insufficiente. Il buffer di destinazione contiene una versione troncata e terminata null del risultato previsto. |
|
Questo stato di errore indica che la funzione ha ricevuto un parametro di input non valido. Per altre informazioni, vedere l'elenco seguente. |
RtlUnicodeStringCchCopyN restituisce il valore di STATUS_INVALID_PARAMETER quando si verifica uno dei seguenti:
- Il contenuto della struttura UNICODE_STRING non è valido.
- Il buffer di destinazione è già pieno.
- Un puntatore del buffer è NULL.
- La lunghezza del buffer di destinazione è zero, ma è presente una stringa di origine di lunghezza non zero.
- Il valore del parametro cchToCopy è maggiore di NTSTRSAFE_UNICODE_STRING_MAX_CCH.
Commenti
La funzione RtlUnicodeStringCchCopyN usa le dimensioni del buffer di destinazione per assicurarsi che l'operazione di copia non venga scritta oltre la fine del buffer. 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 i valori del puntatore NULL , usare la funzione RtlUnicodeStringCchCopyNEx .
Per altre informazioni sulle funzioni di stringa sicura, vedere Uso di funzioni stringhe sicure.
Requisiti
| 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, in caso contrario PASSIVE_LEVEL |