wvsprintfA-Funktion (winuser.h)

Artikel
11/20/2024

Schreibt formatierte Daten mithilfe eines Zeigers auf eine Liste von Argumenten in den angegebenen Puffer. Die elemente, auf die die Argumentliste verweist, werden entsprechend der entsprechenden Formatspezifikation in der Formatsteuerelementzeichenfolge in einen Ausgabepuffer konvertiert und kopiert. Die Funktion fügt ein endendes NULL-Zeichen an die Zeichen an, die er schreibt, aber der Rückgabewert enthält nicht das endende Nullzeichen in der Zeichenanzahl.

Warnung Nicht verwenden. Verwenden Sie stattdessen eine der folgenden Funktionen: StringCbVPrintf, StringCbVPrintfEx, StringCchVPrintfoder StringCchVPrintfEx. Siehe Sicherheitsüberlegungen.

Syntax

int wvsprintfA(
  [out] LPSTR   unnamedParam1,
  [in]  LPCSTR  unnamedParam2,
  [in]  va_list arglist
);

Parameter

[out] unnamedParam1

Typ: LPTSTR-

Der Puffer, der die formatierte Ausgabe empfängt. Die maximale Größe des Puffers beträgt 1.024 Byte.

[in] unnamedParam2

Typ: LPCTSTR-

Die Formatsteuerelementspezifikationen. Zusätzlich zu normalen ASCII-Zeichen wird in dieser Zeichenfolge eine Formatspezifikation für jedes Argument angezeigt. Weitere Informationen zur Formatspezifikation finden Sie in der wsprintf--Funktion.

[in] arglist

Typ: va_list

Jedes Element dieser Liste gibt ein Argument für die Formatsteuerelementzeichenfolge an. Die Anzahl, Typ und Interpretation der Argumente hängen von den entsprechenden Formatsteuerelementspezifikationen im lpFmt Parameter ab.

Rückgabewert

Typ: int

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der zeichen, die im Puffer gespeichert sind, und nicht das endende Nullzeichen zu zählen.

Wenn die Funktion fehlschlägt, ist der Rückgabewert kleiner als die Länge der erwarteten Ausgabe. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Die Funktion kopiert die Formatsteuerelementzeichenfolge nach Zeichen in das Ausgabepufferzeichen, beginnend mit dem ersten Zeichen in der Zeichenfolge. Wenn eine Formatspezifikation in der Zeichenfolge auftritt, ruft die Funktion den Wert des nächsten verfügbaren Arguments ab (beginnend mit dem ersten Argument in der Liste), konvertiert diesen Wert in das angegebene Format und kopiert das Ergebnis in den Ausgabepuffer. Die Funktion kopiert weiterhin Zeichen und erweitert Formatspezifikationen auf diese Weise, bis sie das Ende der Formatsteuerelementzeichenfolge erreicht. Wenn mehr Argumente als Formatspezifikationen vorhanden sind, werden die zusätzlichen Argumente ignoriert. Wenn nicht genügend Argumente für alle Formatspezifikationen vorhanden sind, sind die Ergebnisse nicht definiert.

Anmerkung

Der winuser.h-Header definiert wvsprintf 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 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 [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll