Freigeben über

StrCatChainW-Funktion (shlwapi.h)

  • Artikel

Verkettet zwei Unicode-Zeichenfolgen. Wird verwendet, wenn wiederholte Verkettungen mit demselben Puffer erforderlich sind.

Syntax

DWORD StrCatChainW(
  [out] PWSTR  pszDst,
        DWORD  cchDst,
        DWORD  ichAt,
  [in]  PCWSTR pszSrc
);

Parameter

[out] pszDst

Typ: PWSTR

Ein Zeiger auf einen Puffer, der, wenn diese Funktion erfolgreich zurückgibt, die mit NULL beendete Unicode-Zeichenfolge empfängt.

cchDst

Art: DWORD

Die Größe des Zielpuffers in Zeichen. Dieser Puffer muss von ausreichender Größe sein, um sowohl Zeichenfolgen als auch ein abschließendes NULL-Zeichen zu enthalten. Wenn der Puffer zu klein ist, wird die endgültige Zeichenfolge abgeschnitten.

ichAt

Art: DWORD

Der Offset in den Zielpuffer, an dem die Anfügeaktion gestartet werden soll. Wenn die Zeichenfolge nicht leer ist, legen Sie diesen Wert auf -1 fest, damit die aktuelle Anzahl der ausgefüllten Zeichen (ohne das abschließende NULL-Zeichen) für Sie berechnet wird.

[in] pszSrc

Typ: PCWSTR

Ein Zeiger auf die Unicode-Quellzeichenfolge, die null beendet wurde.

Rückgabewert

Art: DWORD

Gibt den Offset des NULL-Zeichens nach dem letzten Zeichen zurück, das pszDst hinzugefügt wurde.

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: StringCbCatEx, StringCbCatNEx, StringCchCatEx oder StringCchCatNEx. Lesen Sie sicherheitsrelevante Überlegungen: Microsoft Windows Shell , bevor Sie fortfahren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
Bibliothek Shlwapi.lib
DLL Shlwapi.dll (Version 5.5 oder höher)