Функция 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*

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

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

Тип: HRESULT

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

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

Замечания

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

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows 8 [классические приложения | Приложения UWP]
минимальный поддерживаемый сервер	Windows Server 2012 [классические приложения | Приложения UWP]
целевая платформа	Виндоус
Header	winstring.h
Library	mincore.lib

См. также

WindowsDeleteString