Funzione RtlUnicodeStringCbCatN (ntstrsafe.h)
La funzione RtlUnicodeStringCbCatN concatena due stringhe contenute nelle strutture UNICODE_STRING limitando al tempo stesso le dimensioni della stringa copiata.
Sintassi
NTSTRSAFEDDI RtlUnicodeStringCbCatN(
[in, out] PUNICODE_STRING DestinationString,
[in] PCUNICODE_STRING SourceString,
[in] size_t cbToAppend
);
Parametri
[in, out] DestinationString
Puntatore a una struttura UNICODE_STRING. Questa struttura include un buffer che, all'input, contiene una stringa di destinazione 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 viene aggiunta alla fine della 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à aggiunta alla fine della stringa di destinazione. Il numero massimo di byte nel buffer stringa della struttura è NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).
[in] cbToAppend
Numero massimo di byte da aggiungere alla stringa descritta dal parametro DestinationString.
Valore restituito
RtlUnicodeStringCbCatN 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 avviso stato indica che l'operazione di concatenazione non è stata completata a causa di spazio buffer insufficiente. Il buffer di destinazione contiene una versione troncata con terminazione Null del risultato previsto. |
|
Questo errore stato indica che la funzione ha ricevuto un parametro di input non valido. Per altre informazioni, vedere l'elenco seguente. |
RtlUnicodeStringCbCatN restituisce il valore STATUS_INVALID_PARAMETER quando si verifica una delle condizioni seguenti:
- Il contenuto della 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.
- Il valore del parametro cbToAppend è maggiore di NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).
Osservazioni
La funzione RtlUnicodeStringCbCatN usa le dimensioni del buffer di destinazione per garantire che l'operazione di concatenazione non scriva oltre la fine del buffer. La funzione non terminare 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 SourceString e DestinationString non possono essere NULL. Se è necessario gestire valori puntatore NULL, usare la funzione RtlUnicodeStringCbCatNEx.
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 |