nf-shlwapi-strcatchainw.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:shlwapi.StrCatChainW	StrCatChainW function (shlwapi.h)	Concatenates two Unicode strings. Used when repeated concatenations to the same buffer are required.	StrCatChainW StrCatChainW function [Windows Shell] _shell_StrCatChainW shell.StrCatChainW shlwapi/StrCatChainW	shell\StrCatChainW.htm	shell	8df35616-f6f3-45eb-9a83-89fc84938fd7	12/05/2018	StrCatChainW, StrCatChainW function [Windows Shell], _shell_StrCatChainW, shell.StrCatChainW, shlwapi/StrCatChainW	shlwapi.h		Windows	Windows XP [desktop apps only]	Windows Server 2003 [desktop apps only]				StrCatChainW (Unicode)						Shlwapi.lib	Shlwapi.dll (version 5.5 or later)		Windows			19H1	StrCatChainW shlwapi/StrCatChainW	c++	APIRef kbSyntax	DllExport	Shlwapi.dll API-MS-Win-Core-shlwapi-Obsolete-l1-1-0.dll KernelBase.dll API-MS-Win-Core-shlwapi-Obsolete-l1-2-0.dll API-MS-Win-DownLevel-shlwapi-l1-1-0.dll API-MS-Win-DownLevel-shlwapi-l1-1-1.dll	StrCatChainW StrCatChainW

StrCatChainW function

-description

Concatenates two Unicode strings. Used when repeated concatenations to the same buffer are required.

-parameters

-param pszDst [out]

Type: PWSTR

A pointer to a buffer that, when this function returns successfully, receives the null-terminated, Unicode string.

-param cchDst

Type: DWORD

The size of the destination buffer, in characters. This buffer must be of sufficient size to hold both strings as well as a terminating null character. If the buffer is too small, the final string is truncated.

-param ichAt

Type: DWORD

The offset into the destination buffer at which to begin the append action. If the string is not empty, set this value to -1 to have the current number of filled characters (not including the terminating null character) calculated for you.

-param pszSrc [in]

Type: PCWSTR

A pointer to the null-terminated Unicode source string.

-returns

Type: DWORD

Returns the offset of the null character after the last character added to pszDst.

-remarks

Security Warning:  Using this function incorrectly can compromise the security of your application. The final string is not guaranteed to be null-terminated. Consider using one of the following alternatives: StringCbCatEx, StringCbCatNEx, StringCchCatEx, or StringCchCatNEx. You should review Security Considerations: Microsoft Windows Shell before continuing.