Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

StrCatBuff function

Copies and appends characters from one string to the end of another.

Note  Do not use. See Remarks for alternative functions.

Syntax


PTSTR StrCatBuff(
  _Inout_  PTSTR pszDest,
  _In_     PCTSTR pszSrc,
  int cchDestBuffSize
);

Parameters

pszDest [in, out]

Type: PTSTR

A pointer to a null-terminated string. When this function returns successfully, this string contains its original content with the string pszSrc appended.

pszSrc [in]

Type: PCTSTR

A pointer to the string to be appended to pszDest.

cchDestBuffSize

Type: int

The size of the buffer, in characters, pointed to by pszDest. This value must be at least the length of the combined string plus the terminating null character. If the buffer is too small to fit the entire string, the string will be truncated.

Return value

Type: PTSTR

Returns a pointer to the destination string.

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: StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCat, StringCchCatEx, StringCchCatN, or StringCchCatNEx. You should review Security Considerations: Microsoft Windows Shell before continuing.

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Shlwapi.h

Library

Shlwapi.lib

DLL

Shlwapi.dll (version 5.0 or later)

Unicode and ANSI names

StrCatBuffW (Unicode) and StrCatBuffA (ANSI)

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.