Funzione RtlUnicodeStringCbCopyStringN (ntstrsafe.h)

Articolo
02/07/2025

La funzione RtlUnicodeStringCbCopyStringN copia una stringa in una struttura UNICODE_STRING limitando al tempo stesso le dimensioni della stringa copiata.

Sintassi

NTSTRSAFEDDI RtlUnicodeStringCbCopyStringN(
  [out] PUNICODE_STRING  DestinationString,
  [in]  NTSTRSAFE_PCWSTR pszSrc,
  [in]  size_t           cbToCopy
);

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 DestinationStr ing. Il numero massimo di byte nella stringa è NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).

[in] pszSrc

Puntatore alla stringa da copiare.

[in] cbToCopy

Numero di byte da copiare dall'origine alla destinazione.

Valore restituito

RtlUnicodeStringCbCopyN 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.

RtlUnicodeStringCbCopyN 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 cbToCopy è maggiore di NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).

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

Osservazioni

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

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

Vedere anche

RtlUnicodeStringCbCopyNEx

RtlUnicodeStringCchCopyN

UNICODE_STRING

Condividi tramite