Funzione wvnsprintfA (shlwapi.h)

Articolo
11/20/2024

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

Nota Non usare questa funzione. Vedere La sezione 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 viene restituita 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 utilizzato in un formato non associato. Per evitare potenziali sovraccarichi 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, escluso qualsiasi carattere di terminazione NULL. Se si verifica un errore, viene restituito un valore negativo.

Osservazioni

avviso di sicurezza: L'uso di questa funzione in modo non corretto può compromettere la sicurezza dell'applicazione. Non è garantito che la stringa copiata sia con terminazione Null. Prendere in considerazione l'uso di una delle alternative seguenti. StringCbPrintf, StringCbPrintfEx, StringCbVPrintf, StringCbVPrintfEx, StringCchPrintf, StringCchPrintfEx, StringCchVPrintfo StringCchVPrintfEx. Prima di continuare, esaminare Considerazioni sulla sicurezza: Microsoft Windows Shell.

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 5.0 o successiva)

Condividi tramite