StrNCatA-Funktion (shlwapi.h)

Artikel
08/26/2023

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

Hinweis Verwenden Sie diese Funktion oder das StrCatN-Makro nicht. Weitere Informationen finden Sie unter Hinweise zu alternativen Funktionen.

Syntax

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

Parameter

[in, out] psz1

Typ: PTSTR

Ein Zeiger auf eine NULL-endende 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-endende 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 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. Beachten Sie, dass das letzte Argument , cchMax, die Anzahl der Zeichen ist, die in psz1 kopiert werden sollen, und nicht unbedingt die Größe von psz1 in Bytes. Erwägen Sie die Verwendung einer der folgenden Alternativen. StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCatEx, StringCchCatEx, StringCchCatN oder StringCchCatNEx. Lesen Sie sicherheitsrelevante Überlegungen: Microsoft Windows Shell , bevor Sie fortfahren.

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 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


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