Funzione wnsprintfA (shlwapi.h)

Articolo
11/20/2024

Accetta un elenco di argomenti a lunghezza variabile 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 wnsprintfA(
  [out] PSTR  pszDest,
  [in]  int   cchDest,
  [in]  PCSTR pszFmt,
        ...   
);

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

...

Parametri aggiuntivi che contengono i dati da restituire.

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.

Si tratta di una versione di Windows di sprintf. Non supporta tipi a virgola mobile o puntatore. Supporta solo il flag di allineamento sinistro.

Nota

L'intestazione shlwapi.h definisce wnsprintf 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