Funzione RtlUnicodeStringCchCatStringN (ntstrsafe.h)
La funzione RtlUnicodeStringCchCatStringN concatena due stringhe quando la stringa di destinazione è contenuta in una struttura UNICODE_STRING , limitando le dimensioni della stringa aggiunta.
Sintassi
NTSTRSAFEDDI RtlUnicodeStringCchCatStringN(
[in, out] PUNICODE_STRING DestinationString,
[in] NTSTRSAFE_PCWSTR pszSrc,
[in] size_t cchToAppend
);
Parametri
[in, out] DestinationString
Puntatore a una struttura UNICODE_STRING . Questa struttura include un buffer che, in input, contiene una stringa a cui verrà concatenata la stringa di origine. Nell'output, questo buffer è il buffer di destinazione che contiene l'intera stringa risultante. La stringa di origine (esclusa la terminazione NULL) viene aggiunta alla fine della stringa di destinazione. Il numero massimo di caratteri nel buffer stringa della struttura è NTSTRSAFE_UNICODE_STRING_MAX_CCH.
[in] pszSrc
Puntatore fornito dal chiamante a una stringa con terminazione null. Questa stringa verrà concatenata alla fine della stringa contenuta nella struttura UNICODE_STRING del parametro DestinationString.
[in] cchToAppend
Numero massimo di caratteri da aggiungere alla stringa descritta dal parametro DestinationString .
Valore restituito
RtlUnicodeStringCchCatStringN restituisce uno dei valori NTSTATUS seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Questo stato di esito positivo indica che i dati di origine erano presenti, le stringhe sono state concatenate senza troncamento e il buffer di destinazione risultante viene terminato con null. |
|
Questo stato di avviso indica che l'operazione concatenata 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. |
RtlUnicodeStringCchCatStringN restituisce il valore STATUS_INVALID_PARAMETER quando si verifica una delle operazioni 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 cchToAppend è maggiore di NTSTRSAFE_UNICODE_STRING_MAX_CCH.
Commenti
La funzione RtlUnicodeStringCchCatStringN usa le dimensioni del buffer di destinazione per assicurarsi che l'operazione di concatenazione non venga scritta oltre la fine del buffer. La funzione non termina la stringa risultante con un valore di carattere Null, ovvero con zero.
Se le stringhe di origine e di destinazione si sovrappongono, il comportamento della funzione non è definito.
I puntatori pszSrc e DestinationString non possono essere NULL. Se è necessario gestire i valori del puntatore NULL , usare la funzione RtlUnicodeStringCchCatStringNEx .
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 |