Funzione RtlStringCbCopyUnicodeString (ntstrsafe.h)

Articolo
02/07/2025

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 di UNICODE_STRING del parametro SourceString viene copiata 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 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 che contiene 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
STATUS_SUCCESS	Questo esito positivo stato indica che i dati di origine erano presenti, la stringa è stata copiata senza troncamento e il buffer di destinazione risultante viene terminato con null.
STATUS_BUFFER_OVERFLOW	Questo avviso stato indica che l'operazione di copia non è stata completata a causa di spazio buffer insufficiente. Il buffer di destinazione contiene una versione troncata con terminazione Null del risultato previsto.
STATUS_INVALID_PARAMETER	Questo errore stato 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 di UNICODE_STRING non è valido.
Il valore in cbDest è maggiore della dimensione massima del buffer.
Il buffer di destinazione (che pszDest punta a) è 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 Uso di valori NTSTATUS.

Osservazioni

La funzione RtlStringCbCopyUnicodeString usa le dimensioni del buffer di destinazione (che il parametro cbDest specifica) per assicurarsi 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 valori di 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.

Fabbisogno

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	Qualsiasi se le stringhe modificate sono sempre residenti in memoria, altrimenti PASSIVE_LEVEL

Vedere anche

RtlStringCbCopyUnicodeStringEx

RtlStringCchCopyUnicodeString

UNICODE_STRING

Condividi tramite