wnsprintfW-Funktion (shlwapi.h)

  • Artikel

Verwendet eine Argumentliste mit variabler Länge und gibt die Werte der Argumente als formatierte Zeichenfolge im Printf-Format zurück.

Hinweis Verwenden Sie diese Funktion nicht. Weitere Informationen finden Sie unter Hinweise zu alternativen Funktionen.
 

Syntax

int wnsprintfW(
  [out] PWSTR  pszDest,
  [in]  int    cchDest,
  [in]  PCWSTR pszFmt,
        ...    
);

Parameter

[out] pszDest

Typ: PTSTR

Ein Zeiger auf einen Puffer, der bei erfolgreicher Rückgabe dieser Funktion die Ausgabezeichenfolge empfängt.

[in] cchDest

Typ: int

Die maximal zulässige Anzahl von Zeichen in pszDest.

[in] pszFmt

Typ: PCTSTR

Eine Formatzeichenfolge im Printf-Format. Der %s-Formatbezeichner sollte niemals in einer ungebundenen Form verwendet werden. Um potenzielle Pufferüberläufe zu vermeiden, geben Sie immer eine Größe an. für instance "%32s".

...

Zusätzliche Parameter, die die auszugebenden Daten enthalten.

Rückgabewert

Typ: int

Gibt die Anzahl von Zeichen zurück, die in den Puffer geschrieben wurden, wobei alle beendenden NULL-Zeichen ausgeschlossen sind. Ein negativer Wert wird zurückgegeben, wenn ein Fehler auftritt.

Hinweise

Sicherheitswarnung: Die falsche Verwendung dieser Funktion kann die Sicherheit Ihrer Anwendung gefährden. Die kopierte Zeichenfolge ist nicht garantiert null-beendet. Ziehen Sie eine der folgenden Alternativen in Betracht. StringCbPrintf, StringCbPrintfEx, StringCbVPrintf, StringCbVPrintfEx, StringCchPrintf, StringCchPrintfEx, StringCchPrintfEx, StringCchVPrintfOder StringCchVPrintfEx. Bevor Sie fortfahren, sollten Sie Sicherheitsüberlegungen: Microsoft Windows Shell lesen.

Dies ist eine Windows-Version von sprintf. Gleitkomma- oder Zeigertypen werden nicht unterstützt. Es unterstützt nur das linke Ausrichtungsflag.

Hinweis

Der shlwapi.h-Header definiert wnsprintf als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
Bibliothek Shlwapi.lib
DLL Shlwapi.dll (Version 5.0 oder höher)