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 处开始的子字符串等效的字符串;如果 startIndex 等于字符串的长度，则为 NULL。

类型： HRESULT

此函数可以返回其中一个值。

返回代码	说明
S_OK	已成功创建子字符串。
E_INVALIDARG	newString 为 NULL，或 startIndex 加长大于 MAXUINT32，即 4,294,967,295;即十六进制0xFFFFFFFF。
E_BOUNDS	startIndex 大于字符串的长度，或 startIndex 加长度指示不在字符串内的位置。
E_OUTOFMEMORY	未能分配新的子字符串。

每次调用 WindowsSubstringWithSpecifiedLength 函数必须与对 WindowsDeleteString 的相应调用匹配。