从指定的字符串中检索子字符串。 子字符串从指定的字符位置开始,并具有指定的长度。
Syntax
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
此函数可以返回其中一个值。
| 返回代码 | Description |
|---|---|
|
已成功创建子字符串。 |
|
newString 为 NULL,或 startIndex 加 长度 大于 MAXUINT32,即 4,294,967,295;即十六进制0xFFFFFFFF。 |
|
startIndex 大于 字符串的长度,或 startIndex 加 长度 表示不在 字符串中的位置。 |
|
未能分配新的子字符串。 |
注解
每次对 WindowsSubstringWithSpecifiedLength 函数的调用都必须与对 WindowsDeleteString 的相应调用匹配。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows 8 [桌面应用 |UWP 应用] |
| 支持的最低服务器 | Windows Server 2012 [桌面应用 |UWP 应用] |
| 目标平台 | Windows操作系统 |
| Header | winstring.h |
| Library | mincore.lib |