wnsprintfA-Funktion (shlwapi.h)

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

Syntax

int wnsprintfA(
  [out] PSTR  pszDest,
  [in]  int   cchDest,
  [in]  PCSTR pszFmt,
        ...   
);

Parameter

[out] pszDest

Typ: PTSTR

Ein Zeiger auf einen Puffer, der die Ausgabezeichenfolge empfängt, wenn diese Funktion erfolgreich zurückgegeben wird.

[in] cchDest

Typ: int

Die maximale Anzahl von Zeichen, die in pszDest zulässig sind.

[in] pszFmt

Typ: PCTSTR

Eine Formatzeichenfolge im Printf-Format. Der %s-Formatbezeichner sollte niemals in einem ungebundenen Format verwendet werden. Geben Sie immer eine Größe an, um potenzielle Pufferüberläufe zu vermeiden. 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 werden, ausgenommen alle beendenden NULL-Zeichen . Wenn ein Fehler auftritt, wird ein negativer Wert zurückgegeben.

Hinweise

Sicherheitswarnung: Die falsche Verwendung dieser Funktion kann die Sicherheit Ihrer Anwendung beeinträchtigen. Es ist nicht garantiert, dass die kopierte Zeichenfolge null-beendet ist. Erwägen Sie die Verwendung einer der folgenden Alternativen. StringCbPrintf, StringCbPrintfEx, StringCbVPrintf, StringCbVPrintfEx, StringCchPrintf, StringCchPrintfEx, StringCchVPrintf oder StringCchVPrintfEx. Lesen Sie sicherheitsrelevante Überlegungen: Microsoft Windows Shell , bevor Sie fortfahren.

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

Anforderungen