wnsprintfA-Funktion (shlwapi.h)

Artikel
03/13/2024

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

Hinweis Verwenden Sie diese Funktion nicht. Weitere Informationen finden Sie unter Hinweise zu alternativen Funktionen.

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.

Hinweis

Der shlwapi.h-Header definiert wnsprintf 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
Bibliothek	Shlwapi.lib
DLL	Shlwapi.dll (Version 5.0 oder höher)

Freigeben über