wvnsprintfW-Funktion (shlwapi.h)

Artikel
11/20/2024

Verwendet eine Liste von Argumenten und gibt die Werte der Argumente als printf-formatierte Zeichenfolge zurück.

Hinweis Verwenden Sie diese Funktion nicht. Informationen zu alternativen Funktionen finden Sie in den Hinweisen.

Syntax

int wvnsprintfW(
  [out] PWSTR   pszDest,
  [in]  int     cchDest,
  [in]  PCWSTR  pszFmt,
  [in]  va_list arglist
);

Parameter

[out] pszDest

Typ: PTSTR-

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

[in] cchDest

Typ: int

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

[in] pszFmt

Typ: PCTSTR-

Eine Formatzeichenfolge im Format "printf". Der %s Formatbezeichner sollte niemals in einem ungebundenen Format verwendet werden. Um potenzielle Pufferüberläufe zu vermeiden, geben Sie immer eine Größe an. z. B. "%32s".

[in] arglist

Typ: va_list

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

Rückgabewert

Typ: int

Gibt die Anzahl der Zeichen zurück, die in den Puffer geschrieben wurden, mit Ausnahme aller endenden NULL-zeichen Zeichen. Wenn ein Fehler auftritt, wird ein negativer Wert zurückgegeben.

Bemerkungen

Sicherheitswarnung: Die Verwendung dieser Funktion kann die Sicherheit Ihrer Anwendung beeinträchtigen. Die kopierte Zeichenfolge ist nicht garantiert null-beendet. Erwägen Sie die Verwendung einer der folgenden Alternativen. StringCbPrintf, StringCbPrintfEx, StringCbVPrintf, StringCbVPrintfEx, String StringCchPrintf, StringCchPrintfEx, StringCchVPrintfoder StringCchVPrintfEx. Sie sollten Sicherheitsüberlegungen überprüfen: Microsoft Windows Shell, bevor Sie fortfahren.

Anmerkung

Der Header "shlwapi.h" 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 Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 5.0 oder höher)

Freigeben über