StrCatBuffA-Funktion (shlwapi.h)

  • Artikel

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

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

Syntax

PSTR StrCatBuffA(
  [in, out] PSTR  pszDest,
  [in]      PCSTR pszSrc,
            int   cchDestBuffSize
);

Parameter

[in, out] pszDest

Typ: PTSTR

Ein Zeiger auf eine NULL-endende Zeichenfolge. Wenn diese Funktion erfolgreich zurückgibt, enthält diese Zeichenfolge den ursprünglichen Inhalt, an den die Zeichenfolge pszSrc angefügt ist.

[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 pszDest verweist. Dieser Wert muss mindestens die Länge der kombinierten Zeichenfolge plus dem endenden NULL-Zeichen sein. Wenn der Puffer zu klein für die gesamte Zeichenfolge ist, 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 beeinträchtigen. 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, StringCchCatEx, StringCchCatN oder StringCchCatNEx. Lesen Sie sicherheitsrelevante Überlegungen: Microsoft Windows Shell , bevor Sie fortfahren.

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