Funzione RtlUnicodeStringCopyString (ntstrsafe.h)

Articolo
05/03/2024

La funzione RtlUnicodeStringCopyString copia una stringa in una struttura UNICODE_STRING .

Sintassi

NTSTRSAFEDDI RtlUnicodeStringCopyString(
  [out] PUNICODE_STRING  DestinationString,
  [in]  NTSTRSAFE_PCWSTR pszSrc
);

Parametri

[out] DestinationString

Puntatore a una struttura UNICODE_STRING che riceve la stringa copiata. La stringa a cui punta il parametro pszSrc (escluso il valore Null di terminazione) viene copiata nel buffer a cui punta la struttura UNICODE_STRING del parametro DestinationString. Il numero massimo di byte nella stringa è NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).

[in] pszSrc

Puntatore a una stringa con terminazione Null. Questa stringa verrà copiata nel buffer a cui punta la struttura UNICODE_STRING del parametro DestinationString.

Valore restituito

RtlUnicodeStringCopyString Restituisce uno dei valori NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	Questo stato di esito positivo indica che i dati di origine erano presenti e che la stringa è stata copiata senza troncamento.
STATUS_BUFFER_OVERFLOW	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.
STATUS_INVALID_PARAMETER	Questo stato di errore indica che la funzione ha ricevuto un parametro di input non valido. Per altre informazioni, vedere l'elenco seguente.

RtlUnicodeStringCopyString restituisce il valore STATUS_INVALID_PARAMETER quando si verifica una delle condizioni seguenti:

Il contenuto della struttura 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.

Per informazioni su come testare i valori NTSTATUS, vedere Utilizzo di valori NTSTATUS.

Commenti

La funzione RtlUnicodeStringCopyString usa le dimensioni del buffer di destinazione per garantire che l'operazione di concatenazione 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 pszSrc e DestinationString non possono essere NULL. Se è necessario gestire i valori del puntatore NULL , usare la funzione RtlUnicodeStringCopyStringEx .

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 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	Se le stringhe modificate sono sempre residenti in memoria, in caso contrario PASSIVE_LEVEL

Vedi anche

RtlUnicodeStringCopyStringEx

UNICODE_STRING

Condividi tramite