WindowsConcatString function (winstring.h)

Concatenates two specified strings.

Syntax

HRESULT WindowsConcatString(
  HSTRING string1,
  HSTRING string2,
  HSTRING *newString
);

Parameters

string1

Type: [in] HSTRING

The first string to be concatenated.

string2

Type: [in] HSTRING

The second string to be concatenated.

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.

Return value

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.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 [desktop apps | UWP apps]
Target Platform Windows
Header winstring.h

See also

WindowsDeleteString