Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

WindowsConcatString function

Concatenates two specified strings.

Syntax


HRESULT WINAPI WindowsConcatString(
  _In_   HSTRING string1,
  _In_   HSTRING string2,
  _Out_  HSTRING *newString
);

Parameters

string1 [in]

Type: HSTRING

The first string to be concatenated.

string2 [in]

Type: HSTRING

The second string to be concatenated.

newString [out]

Type: 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 codeDescription
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

Windows Phone 8: This API is supported.

Windows Phone 8.1: This API is supported.

Requirements

Minimum supported client

Windows 8 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 [desktop apps | Windows Store apps]

Header

Winstring.h

 

 

Community Additions

Show:
© 2014 Microsoft