Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

StrCatChainW function

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

Syntax


DWORD StrCatChainW(
  _Out_ PWSTR  pszDst,
        DWORD  cchDst,
        DWORD  ichAt,
  _In_  PCWSTR pszSrc
);

Parameters

pszDst [out]

Type: PWSTR

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

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.

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.

pszSrc [in]

Type: PCWSTR

A pointer to the null-terminated Unicode source string.

Return value

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.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Shlwapi.h

Library

Shlwapi.lib

DLL

Shlwapi.dll (version 5.5 or later)

Unicode and ANSI names

StrCatChainW (Unicode)

 

 

Community Additions

ADD
Show:
© 2015 Microsoft