Export (0) Print
Expand All
Expand Minimize

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

ADD
Show:
© 2014 Microsoft