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 l'elenco degli 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 in stile printf.
...
facoltativo. 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 |
|---|---|
|
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 viene terminato con valore Null. |
|
Questo stato di avviso indica che l'operazione non è stata completata a causa di spazio buffer insufficiente. Il buffer di destinazione contiene una versione troncata e terminata null 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. |
RtlUnicodeStringPrintf restituisce il valore di STATUS_INVALID_PARAMETER quando si verifica uno dei seguenti:
- Il contenuto della struttura UNICODE_STRING che il parametro DestinationString punta a 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 non zero.
Commenti
La funzione RtlUnicodeStringPrintf usa le dimensioni del buffer di destinazione per assicurarsi che l'operazione di formattazione della stringa non venga scritta 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 i valori del puntatore NULL , usare la funzione RtlUnicodeStringPrintfEx .
Per altre informazioni sulle funzioni di stringa sicura, vedere Uso di funzioni stringhe sicure.
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 | Qualsiasi se le stringhe modificate sono sempre residenti in memoria, in caso contrario PASSIVE_LEVEL |