StrCatBuffW-Funktion (shlwapi.h)

Artikel
08/26/2023

Kopiert Zeichen aus einer Zeichenfolge und fügt sie an das Ende einer anderen an.

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

Syntax

PWSTR StrCatBuffW(
  [in, out] PWSTR  pszDest,
  [in]      PCWSTR pszSrc,
            int    cchDestBuffSize
);

Parameter

[in, out] pszDest

Typ: PTSTR

Ein Zeiger auf eine NULL-Zeichenfolge. Wenn diese Funktion erfolgreich zurückgegeben wird, enthält diese Zeichenfolge ihren ursprünglichen Inhalt mit der angefügten Zeichenfolge pszSrc .

[in] pszSrc

Typ: PCTSTR

Ein Zeiger auf die Zeichenfolge, die an pszDest angefügt werden soll.

cchDestBuffSize

Typ: int

Die Größe des Puffers in Zeichen, auf die von pszDest verwiesen wird. Dieser Wert muss mindestens die Länge der kombinierten Zeichenfolge plus das beendende NULL-Zeichen aufweisen. Wenn der Puffer zu klein ist, um die gesamte Zeichenfolge zu passen, wird die Zeichenfolge abgeschnitten.

Rückgabewert

Typ: PTSTR

Gibt einen Zeiger zur Zielzeichenfolge zurück.

Hinweise

Sicherheitswarnung: Die falsche Verwendung dieser Funktion kann die Sicherheit Ihrer Anwendung gefährden. Es ist nicht garantiert, dass die endgültige Zeichenfolge null-beendet ist. Erwägen Sie die Verwendung einer der folgenden Alternativen: StringCbCat,StringCbCatEx, StringCbCatN , StringCbCatNEx, StringCchCat,StringCchCatEx, StringCchCatN oder StringCchCatNEx. Bevor Sie fortfahren, sollten Sie Sicherheitsüberlegungen: Microsoft Windows Shell lesen.

Hinweis

Der shlwapi.h-Header definiert StrCatBuff 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 5.0 oder höher)

Share via