Funzione wnsprintfA (shlwapi.h)

Articolo
08/26/2023

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

Nota Non usare questa funzione. Per le funzioni alternative, vedere La sezione Osservazioni.

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 di tipo printf. 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, esclusi i caratteri NULL di terminazione. Se si verifica un errore, viene restituito un valore negativo.

Commenti

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, StringCchVPrintf o StringCchVPrintfEx. Prima di continuare, vedere Considerazioni sulla sicurezza: Microsoft Windows Shell .

Questa è una versione di Windows 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 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, 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