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

  • Статья

Создает новый объект HSTRING на основе указанной исходной строки.

Синтаксис

HRESULT WindowsCreateString(
  PCNZWCH sourceString,
  UINT32  length,
  HSTRING *string
);

Параметры

sourceString

Тип: [in, необязательный] LPCWSTR

Строка, завершающаяся нулевым значением, которая используется в качестве источника для нового HSTRING. Чтобы создать новую, пустую строку или строку NULL , передайте значение NULL для sourceString и 0 для длины.

length

Тип: [in] UINT32

Длина sourceString в символах Юникода. Значение должно быть равно 0, если sourceString имеет значение NULL.

string

Тип: [out] HSTRING*

Указатель на только что созданный объект HSTRING или ЗНАЧЕНИЕ NULL , если возникает ошибка. Любое существующее содержимое в строке перезаписывается. HSTRING — это стандартный тип дескриптора.

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

Тип: HRESULT

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

Код возврата Описание
S_OK
 HSTRING успешно создан.
E_INVALIDARG
 string имеет значение NULL.
E_OUTOFMEMORY
 Не удалось выделить новый объект HSTRING.
E_POINTER
 sourceString имеет значение NULL , а длина не равна нулю.

Комментарии

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

Вызовите функцию WindowsDeleteString , чтобы удалить выделение HSTRING. Каждый вызов функции WindowsCreateString должен соответствовать вызову WindowsDeleteString.

Чтобы создать новую, пустую строку или строку NULL , передайте значение NULL для sourceString и 0 для длины.

Если sourceString содержит внедренные символы NULL, функция WindowsCreateString копирует все символы в завершающий символ NULL.

Требования

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

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

WindowsCreateStringReference

WindowsDeleteString