Condividi tramite


Funzione RtlUnicodeStringPrintf (ntstrsafe.h)

La funzione RtlUnicodeStringPrintf crea una stringa di testo, con formattazione basata sulle informazioni di formattazione fornite e archivia la stringa in una struttura UNICODE_STRING.

Sintassi

NTSTRSAFEDDI RtlUnicodeStringPrintf(
  [out] PUNICODE_STRING  DestinationString,
  [in]  NTSTRSAFE_PCWSTR pszFormat,
        ...              
);

Parametri

[out] DestinationString

Puntatore a una struttura UNICODE_STRING che riceve una stringa formattata. RtlUnicodeStringPrintf crea questa stringa dalla stringa di formattazione che pszFormat specifica e dall'elenco di argomenti della funzione. Il numero massimo di caratteri nella stringa è NTSTRSAFE_UNICODE_STRING_MAX_CCH.

[in] pszFormat

Puntatore a una stringa di testo con terminazione Null contenente direttive di formattazione con stile.

...

Opzionale. Elenco di argomenti interpretati dalla funzione, in base alle direttive di formattazione contenute nella stringa pszFormat.

Valore restituito

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

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

  • Il contenuto della struttura di UNICODE_STRING a cui punta il parametro DestinationString non è valido.
  • Il buffer di destinazione è già pieno.
  • È presente un puntatore 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 RtlUnicodeStringPrintf usa le dimensioni del buffer di destinazione per garantire che l'operazione di formattazione della stringa non scriva oltre la fine del buffer. La funzione non termina la stringa risultante con un carattere Null.

Se la stringa di formato e la stringa di destinazione si sovrappongono, il comportamento della funzione non è definito.

I puntatori pszFormat e DestinationString non possono essere NULL. Se è necessario gestire valori puntatore NULL, usare la funzione RtlUnicodeStringPrintfEx.

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

RtlUnicodeStringPrintfEx

RtlUnicodeStringVPrintf

RtlUnicodeStringVPrintfEx

UNICODE_STRING