lstrcatW function (winbase.h)

Appends one string to another.

Warning  Do not use. Consider using StringCchCat instead. See Security Considerations.
 

Syntax

LPWSTR lstrcatW(
  [in, out] LPWSTR  lpString1,
  [in]      LPCWSTR lpString2
);

Parameters

[in, out] lpString1

Type: LPTSTR

The first null-terminated string. This buffer must be large enough to contain both strings.

[in] lpString2

Type: LPTSTR

The null-terminated string to be appended to the string specified in the lpString1 parameter.

Return value

Type: LPTSTR

If the function succeeds, the return value is a pointer to the buffer.

If the function fails, the return value is NULL and lpString1 may not be null-terminated.

Remarks

Note

The winbase.h header defines lstrcat as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header winbase.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See also

Conceptual

Reference

StringCbCat

StringCbCatEx

StringCbCatN

StringCbCatNEx

StringCchCat

StringCchCatEx

StringCchCatN

StringCchCatNEx

Strings

lstrcmp

lstrcmpi

lstrlen