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

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

Синтаксис

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

Параметры

sourceString

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

Текстовый буфер в кодировке UTF-16LE, используемый в качестве источника для нового HSTRING. Чтобы создать новую, пустую или пустую строку, передайте значение NULL для sourceString и 0 для длины.

Этот буфер не требуется завершать значение NULL. WindowsCreateString скопирует его содержимое и добавит терминатор NULL в новый буфер, который поддерживает возвращенный HSTRING.

length

Тип: [in] UINT32

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

string

Тип: [out] HSTRING*

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

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

Тип: HRESULT

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

Замечания

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

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

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

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

Требования

См. также

WindowsCreateStringReference

WindowsDeleteString