StrCatW-Funktion (shlwapi.h)

  • Artikel

Fügt eine Zeichenfolge an eine andere an.

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

Syntax

PWSTR StrCatW(
  [in, out] PWSTR  psz1,
  [in]      PCWSTR psz2
);

Parameter

[in, out] psz1

Typ: PTSTR

Ein Zeiger auf eine NULL-endende Zeichenfolge. Wenn diese Funktion erfolgreich zurückgegeben wird, enthält diese Zeichenfolge den ursprünglichen Inhalt, an den die Zeichenfolge psz2 angefügt ist. Dieser Puffer muss groß genug sein, um sowohl Zeichenfolgen als auch das abschließende NULL-Zeichen zu enthalten.

[in] psz2

Typ: PCTSTR

Ein Zeiger auf eine NULL-endende Zeichenfolge, die an psz1 angefügt werden soll.

Rückgabewert

Typ: PTSTR

Gibt einen Zeiger auf psz1 zurück, der die kombinierten Zeichenfolgen enthält.

Hinweise

Sicherheitswarnung: Die falsche Verwendung dieser Funktion kann die Sicherheit Ihrer Anwendung beeinträchtigen. Das erste Argument psz1 muss groß genug sein, um psz2 und das schließende "\0" zu enthalten. Andernfalls kann es zu einem Pufferüberlauf kommen. Pufferüberläufe können zu einem Denial-of-Service-Angriff auf die Anwendung führen, wenn eine Zugriffsverletzung auftritt. Im schlimmsten Fall kann ein Pufferüberlauf es einem Angreifer ermöglichen, ausführbaren Code in Ihren Prozess einzufügen, insbesondere wenn psz1 ein stapelbasierter Puffer ist. Erwägen Sie die Verwendung einer der folgenden Alternativen: StringCbCat,StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCatEx, StringCchCatN oder StringCchCatNEx. Lesen Sie sicherheitsrelevante Überlegungen: Microsoft Windows Shell , bevor Sie fortfahren.

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 4.71 oder höher)