funzione wvnsprintfA (shlwapi.h)

Articolo
03/05/2024

Accetta un elenco di argomenti e restituisce i valori degli argomenti come stringa formattata in stile printf.

Nota Non usare questa funzione. Vedere Osservazioni per le funzioni alternative.

Sintassi

int wvnsprintfA(
  [out] PSTR    pszDest,
  [in]  int     cchDest,
  [in]  PCSTR   pszFmt,
  [in]  va_list arglist
);

Parametri

[out] pszDest

Tipo: PTSTR

Puntatore a un buffer che, quando questa funzione restituisce correttamente, riceve la stringa di output.

[in] cchDest

Tipo: int

Numero massimo di caratteri consentiti in pszDest.

[in] pszFmt

Tipo: PCTSTR

Stringa di formato printf-style. L'identificatore di formato %s non deve mai essere usato in un modulo non associato. Per evitare potenziali overrun del buffer, specificare sempre una dimensione; ad esempio "%32s".

[in] arglist

Tipo: va_list

Puntatore a un elenco di parametri della riga di comando usati per personalizzare l'output.

Valore restituito

Tipo: int

Restituisce il numero di caratteri scritti nel buffer, esclusi eventuali caratteri NULL terminanti. Viene restituito un valore negativo se si verifica un errore.

Commenti

Avviso di sicurezza: L'uso di questa funzione in modo errato può compromettere la sicurezza dell'applicazione. La stringa copiata non è garantita la terminazione null. È consigliabile usare una delle alternative seguenti. StringCbPrintf, StringCbPrintfEx, StringCbVPrintf, StringCbVPrintfEx, StringCchPrintfEx, StringCchPrintfEx, StringCchVPrintf o StringCchVPrintfEx. È consigliabile esaminare considerazioni sulla sicurezza: Microsoft Windows Shell prima di continuare.

Nota

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 5.0 o successiva)

Condividi tramite