wvnsprintfA-Funktion (shlwapi.h)

Übernimmt eine Liste von Argumenten und gibt die Werte der Argumente als formatierte Zeichenfolge im Printf-Format zurück.

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.

Anforderungen