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

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

  • Статья

Извлекает подстроку из указанной строки. Подстрока начинается с указанной позиции знака и имеет указанную длину.

Синтаксис

HRESULT WindowsSubstringWithSpecifiedLength(
  HSTRING string,
  UINT32  startIndex,
  UINT32  length,
  HSTRING *newString
);

Параметры

string

Тип: [in] HSTRING

Исходная строка.

startIndex

Тип: [in] UINT32

Отсчитываемая от нуля позиция первого знака подстроки в данном экземпляре.

length

Тип: [in] UINT32

Число символов в подстроке.

newString

Тип: [out] HSTRING*

Строка, эквивалентная подстроке, которая начинается с startIndex в строке, или NULL , если startIndex равна длине строки.

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

Тип: HRESULT

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

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

Комментарии

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

Требования

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

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

WindowsDeleteString