wvnsprintfA-Funktion (shlwapi.h)

  • Artikel

Übernimmt eine Liste von Argumenten 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 wvnsprintfA(
  [out] PSTR    pszDest,
  [in]  int     cchDest,
  [in]  PCSTR   pszFmt,
  [in]  va_list arglist
);

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

[in] arglist

Typ: va_list

Ein Zeiger auf eine Liste von Befehlszeilenparametern, die zum Anpassen der Ausgabe verwendet werden.

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.

Hinweis

Der shlwapi.h-Header definiert wvnsprintf als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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)