Funzione RtlStringCbCopyUnicodeString (ntstrsafe.h)
La funzione RtlStringCbCopyUnicodeString copia il contenuto di una struttura UNICODE_STRING in una destinazione specificata.
Sintassi
NTSTRSAFEDDI RtlStringCbCopyUnicodeString(
[out] NTSTRSAFE_PWSTR pszDest,
[in] size_t cbDest,
[in] PCUNICODE_STRING SourceString
);
Parametri
[out] pszDest
Puntatore a un buffer che riceve la stringa copiata. Stringa a cui punta la struttura di UNICODE_STRING del parametro SourceString da copiare nel buffer in pszDest e terminata con un carattere Null.
[in] cbDest
Dimensioni, in byte, del buffer di destinazione a cui pszDest punta. Il buffer deve essere abbastanza grande per contenere la stringa e il carattere null terminante. Il numero massimo di byte nel buffer è NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).
[in] SourceString
Puntatore a una struttura UNICODE_STRING contenente la stringa da copiare. Il numero massimo di byte nella stringa è NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).
Valore restituito
RtlStringCbCopyUnicodeString 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. |
RtlStringCbCopyUnicodeString restituisce il valore STATUS_INVALID_PARAMETER quando si verifica uno dei seguenti:
- Il contenuto della struttura UNICODE_STRING non è valido.
- Il valore in cbDest è maggiore della dimensione massima del buffer.
- Il buffer di destinazione (a cui pszDest punta) è già pieno.
- Un puntatore del buffer è NULL.
- La lunghezza del buffer di destinazione è zero, ma è presente una stringa di origine di lunghezza non zero.
Commenti
La funzione RtlStringCbCopyUnicodeString usa le dimensioni del buffer di destinazione (che il parametro cbDest specifica) per assicurarsi che l'operazione di copia non venga scritta oltre la fine del buffer.
Se le stringhe di origine e di destinazione si sovrappongono, il comportamento della funzione non è definito.
I puntatori SourceString e pszDest non possono essere NULL. Se è necessario gestire i valori del puntatore NULL , usare la funzione RtlStringCbCopyUnicodeStringEx .
Per altre informazioni sulle funzioni di stringa sicura, vedere Uso di funzioni stringhe sicure.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile a partire da Windows XP con Service Pack 1 (SP1). |
Piattaforma di destinazione | Desktop |
Intestazione | ntstrsafe.h (include Ntstrsafe.h) |
Libreria | Ntstrsafe.lib |
IRQL | PASSIVE_LEVEL |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per