wnsprintfA-Funktion (shlwapi.h)

Artikel
11/20/2024

Verwendet eine Argumentliste mit variabler Länge 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 wnsprintfA(
  [out] PSTR  pszDest,
  [in]  int   cchDest,
  [in]  PCSTR pszFmt,
        ...   
);

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

...

Zusätzliche Parameter, die die auszuzugebenden Daten enthalten.

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.

Dies ist eine Windows-Version von sprintf. Sie unterstützt keine Gleitkomma- oder Zeigertypen. Es unterstützt nur das Flag für die linke Ausrichtung.

Anmerkung

Der Header "shlwapi.h" definiert wnsprintf 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, 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