StrCpyW-Funktion (shlwapi.h)

Artikel
08/26/2023

Kopiert eine Zeichenfolge in eine andere.

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

Syntax

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

Parameter

[out] psz1

Typ: PTSTR

Ein Zeiger auf einen Puffer, der bei erfolgreicher Rückgabe dieser Funktion die kopierte Zeichenfolge empfängt. Es ist nicht garantiert, dass diese Zeichenfolge null beendet ist.

[in] psz2

Typ: PCTSTR

Ein Zeiger auf die NULL-beendete Quellzeichenfolge.

Rückgabewert

Typ: PTSTR

Gibt einen Zeiger auf psz1 zurück.

Hinweise

Sicherheitswarnung: Die falsche Verwendung dieser Funktion kann die Sicherheit Ihrer Anwendung gefährden. Das erste Argument , psz1, muss groß genug sein, um psz2 und das schließende "\0" zu enthalten, andernfalls kann ein Pufferüberlauf auftreten. 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, eine der folgenden Alternativen zu verwenden: StringCbCopy, StringCbCopyEx, StringCbCopyNEx, StringCchCopy, StringCchCopyEx, StringCchCopyEx, StringCchCopyN oder StringCchCopyNEx. Bevor Sie fortfahren, sollten Sie Sicherheitsüberlegungen: Microsoft Windows Shell lesen.

Anforderungen


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)

Freigeben über