Funzione wvsprintfW (winuser.h)

Articolo
08/28/2023

Scrive i dati formattati nel buffer specificato usando un puntatore a un elenco di argomenti. Gli elementi a cui punta l'elenco di argomenti vengono convertiti e copiati in un buffer di output in base alla specifica di formato corrispondente nella stringa di controllo formato. La funzione aggiunge un carattere Null di terminazione ai caratteri scritti, ma il valore restituito non include il carattere null di terminazione nel conteggio dei caratteri.

Avviso Non usare. È consigliabile usare una delle funzioni seguenti: StringCbVPrintf, StringCbVPrintfEx, StringCchVPrintf o StringCchVPrintfEx. Vedere Considerazioni sulla sicurezza.

Sintassi

int wvsprintfW(
  [out] LPWSTR  unnamedParam1,
  [in]  LPCWSTR unnamedParam2,
  [in]  va_list arglist
);

Parametri

[out] unnamedParam1

Tipo: LPTSTR

Buffer che deve ricevere l'output formattato. La dimensione massima del buffer è di 1.024 byte.

[in] unnamedParam2

Tipo: LPCTSTR

Specifiche del controllo di formato. Oltre ai caratteri ASCII normali, in questa stringa viene visualizzata una specifica di formato per ogni argomento. Per altre informazioni sulla specifica del formato, vedere la funzione wsprintf .

[in] arglist

Tipo: va_list

Ogni elemento di questo elenco specifica un argomento per la stringa di controllo di formato. Il numero, il tipo e l'interpretazione degli argomenti dipendono dalle specifiche del controllo di formato corrispondenti nel parametro lpFmt .

Valore restituito

Tipo: int

Se la funzione ha esito positivo, il valore restituito è il numero di caratteri archiviati nel buffer, senza contare il carattere null di terminazione.

Se la funzione ha esito negativo, il valore restituito è minore della lunghezza dell'output previsto. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione copia la stringa del controllo di formato nel carattere del buffer di output in base al carattere, a partire dal primo carattere nella stringa. Quando rileva una specifica di formato nella stringa, la funzione recupera il valore dell'argomento disponibile successivo (a partire dal primo argomento nell'elenco), converte tale valore nel formato specificato e copia il risultato nel buffer di output. La funzione continua a copiare i caratteri ed espandere le specifiche di formato in questo modo fino a raggiungere la fine della stringa del controllo di formato. Se sono presenti più argomenti rispetto alle specifiche di formato, gli argomenti aggiuntivi vengono ignorati. Se non sono presenti argomenti sufficienti per tutte le specifiche di formato, i risultati non sono definiti.

Nota

L'intestazione winuser.h definisce wvsprintf come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll