Функция WindowsConcatString (winstring.h)

  • Статья

Объединяет две указанные строки.

Синтаксис

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

Параметры

string1

Тип: [in] HSTRING

Первая строка для объединения.

string2

Тип: [in] HSTRING

Вторая строка для объединения.

newString

Тип: [out] HSTRING*

Объединение строк string1 и string2. Если string1 и string2 имеют значение NULL, newString имеет значение NULL. Если строка string1 или string2 имеет значение NULL, newString — это копия строки, отличной от NULL.

Возвращаемое значение

Тип: HRESULT

Эта функция может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Объединенная строка успешно создана.
E_INVALIDARG
 newString имеет значение NULL, или длина string1 плюс длина string2 больше MAXUINT32, т. е. 4 294 967 295; то есть шестнадцатеричное 0xFFFFFFFF.
E_OUTOFMEMORY
 Не удалось выделить сцепленную строку.

Комментарии

Каждый вызов функции WindowsConcatString должен соответствовать соответствующему вызову WindowsDeleteString.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header winstring.h

См. также раздел

WindowsDeleteString