Функция 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
Эта функция может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
|
Подстрока успешно создана. |
|
newString имеет значение NULL или startIndex plus length больше MAXUINT32, что составляет 4 294 967 295; то есть шестнадцатеричное 0xFFFFFFFF. |
|
параметр startIndex больше длины строки, или startIndex plus length указывает на позицию, отличную от строки. |
|
Не удалось выделить новую подстроку. |
Комментарии
Каждый вызов функции WindowsSubstringWithSpecifiedLength должен соответствовать соответствующему вызову WindowsDeleteString.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2012 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | winstring.h |