Поделиться через


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

Создает копию указанной строки.

Синтаксис

HRESULT WindowsDuplicateString(
  HSTRING string,
  HSTRING *newString
);

Параметры

string

Тип: [in] HSTRING

Копируемые строки.

newString

Тип: [out] HSTRING*

Копия строки.

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

Тип: HRESULT

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

Код возврата Описание
S_OK
HSTRING успешно скопирован.
E_INVALIDARG
newString имеет значение NULL.
E_OUTOFMEMORY
Не удалось выделить новый HSTRING.

Комментарии

Используйте функцию WindowsDuplicateString для копирования HSTRING. Если строка была создана путем вызова функции WindowsCreateString , количество ссылок резервного буфера увеличивается. Если строка была создана путем вызова функции WindowsCreateStringReference, среда выполнения Windows копирует свою исходную строку в новый буфер и запускает счетчик ссылок, что означает, что newString не является быстрой строкой.

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

Требования

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

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

WindowsCreateString

WindowsCreateStringReference

WindowsDeleteString