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


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

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

Синтаксис

HRESULT WindowsDuplicateString(
  HSTRING string,
  HSTRING *newString
);

Параметры

string

Тип: [in] HSTRING

Строка для копирования.

newString

Тип: [out] HSTRING*

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

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

Тип: HRESULT

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

Код возврата Description
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]
целевая платформа Виндоус
Header winstring.h
Library RuntimeObject.lib

См. также

WindowsCreateString

WindowsCreateStringReference

WindowsDeleteString