StrNCatA-Funktion (shlwapi.h)

Artikel
11/20/2024

Fügt eine angegebene Anzahl von Zeichen vom Anfang einer Zeichenfolge an das Ende einer anderen an.

Hinweis Verwenden Sie diese Funktion nicht oder das StrCatN- Makro. Informationen zu alternativen Funktionen finden Sie in den Hinweisen.

Syntax

PSTR StrNCatA(
  [in, out] PSTR  psz1,
            PCSTR psz2,
            int   cchMax
);

Parameter

[in, out] psz1

Typ: PTSTR-

Ein Zeiger auf eine mit Null beendete Zeichenfolge, an die die Funktion die Zeichen aus psz2anfüge. Es muss groß genug sein, um die kombinierten Zeichenfolgen und das endende Nullzeichen zu enthalten.

psz2

Typ: PCTSTR-

Ein Zeiger auf die mit Null beendete Zeichenfolge, die angefügt werden soll.

cchMax

Typ: int

Die Anzahl der Zeichen, die an psz1 vom Anfang psz2angefügt werden sollen.

Rückgabewert

Typ: PTSTR-

Gibt einen Zeiger auf psz1zurück, der die kombinierte Zeichenfolge enthält.

Bemerkungen

Sicherheitswarnung: Die 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 halten, 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 psz1kopiert werden sollen, nicht unbedingt die Größe der psz1- in Byte. Erwägen Sie die Verwendung einer der folgenden Alternativen. StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCat, StringCchCatEx, StringCchCatNoder StringCchCatNEx. Sie sollten Sicherheitsüberlegungen überprüfen: Microsoft Windows Shell, bevor Sie fortfahren.

Anmerkung

Der Header "shlwapi.h" 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 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 4.71 oder höher)

Freigeben über