StrNCatW-Funktion (shlwapi.h)
Fügt eine angegebene Anzahl von Zeichen vom Anfang einer Zeichenfolge an das Ende einer anderen an.
Syntax
PWSTR StrNCatW(
[in, out] PWSTR psz1,
PCWSTR psz2,
int cchMax
);
Parameter
[in, out] psz1
Typ: PTSTR
Ein Zeiger auf eine NULL-Zeichenfolge, an die die Funktion die Zeichen aus psz2 anhängt. Sie muss groß genug sein, um die kombinierten Zeichenfolgen plus das abschließende NULL-Zeichen zu enthalten.
psz2
Typ: PCTSTR
Ein Zeiger auf die NULL-Zeichenfolge, die angefügt werden soll.
cchMax
Typ: int
Die Anzahl der Zeichen, die ab dem Anfang von psz2 an psz1 angefügt werden sollen.
Rückgabewert
Typ: PTSTR
Gibt einen Zeiger auf psz1 zurück, der die kombinierte Zeichenfolge enthält.
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. Beachten Sie, dass das letzte Argument , cchMax, die Anzahl der Zeichen ist, die in psz1 kopiert werden sollen, nicht unbedingt die Größe des psz1 in Bytes. Ziehen Sie eine der folgenden Alternativen in Betracht. StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCat,StringCchCatEx, StringCchCatN, StringCchCatN oder StringCchCatNEx. Bevor Sie fortfahren, sollten Sie Sicherheitsüberlegungen: Microsoft Windows Shell lesen.
Hinweis
Der shlwapi.h-Header definiert StrNCat 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 nicht codierungsneutralem Code 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 4.71 oder höher) |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für