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. La stringa a cui punta la struttura UNICODE_STRING del parametro SourceString viene copiata nel buffer in corrispondenza di pszDest e terminata con un carattere Null.
[in] cbDest
Dimensioni, in byte, del buffer di destinazione a cui punta pszDest . Il buffer deve essere sufficientemente grande da contenere la stringa e il carattere null di terminazione. 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 è con terminazione Null. |
|
Questo stato di avviso indica che l'operazione di copia non è stata completata a causa di spazio del buffer insufficiente. Il buffer di destinazione contiene una versione con terminazione Null troncata 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 una delle condizioni 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 al buffer è NULL.
- La lunghezza del buffer di destinazione è zero, ma è presente una stringa di origine di lunghezza diversa da zero.
Commenti
La funzione RtlStringCbCopyUnicodeString usa le dimensioni del buffer di destinazione (che il parametro cbDest specifica) per garantire che l'operazione di copia non scriva 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 Using Safe String Functions.For more information about the safe string functions, see Using Safe String Functions.
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 | Se le stringhe modificate sono sempre residenti in memoria, in caso contrario PASSIVE_LEVEL |