nf-winstring-windowsconcatstring.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:winstring.WindowsConcatString	WindowsConcatString function (winstring.h)	Concatenates two specified strings.	WindowsConcatString WindowsConcatString function [Windows Runtime] winrt.windowsconcatstring winstring/WindowsConcatString	winrt\windowsconcatstring.htm	WinRT	916E1FC2-CCA1-4B4E-8710-99D5ECA31ABE	12/05/2018	WindowsConcatString, WindowsConcatString function [Windows Runtime], winrt.windowsconcatstring, winstring/WindowsConcatString	winstring.h		Windows	Windows 8 [desktop apps \| UWP apps]	Windows Server 2012 [desktop apps \| UWP apps]													Windows			19H1	WindowsConcatString winstring/WindowsConcatString	c++	APIRef kbSyntax	DllExport	winstring.h API-MS-Win-Core-WinRT-String-l1-1-0.dll ComBase.dll API-MS-Win-Core-WinRT-String-L1-1-1.dll	WindowsConcatString

-description

Concatenates two specified strings.

-parameters

-param string1

Type: [in] HSTRING

The first string to be concatenated.

-param string2

Type: [in] HSTRING

The second string to be concatenated.

-param newString

Type: [out] HSTRING*

The concatenation of string1 and string2. If string1 and string2 are NULL, newString is NULL. If either string1 or string2 is NULL, newString is a copy of the non-null string.

-returns

Type: HRESULT

This function can return one of these values.

Return code	Description
S_OK	The concatenated string was created successfully.
E_INVALIDARG	newString is NULL, or the length of string1 plus the length of string2 is greater than MAXUINT32, which is 4,294,967,295; that is, hexadecimal 0xFFFFFFFF.
E_OUTOFMEMORY	Failed to allocate the concatenated string.

-remarks

Each call to the WindowsConcatString function must be matched with a corresponding call to WindowsDeleteString.

-see-also

WindowsDeleteString