Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Retrieves a substring from the specified string. The substring starts at a specified character position and has a specified length.
Syntax
HRESULT WindowsSubstringWithSpecifiedLength(
HSTRING string,
UINT32 startIndex,
UINT32 length,
HSTRING *newString
);
Parameters
string
Type: [in] HSTRING
The original string.
startIndex
Type: [in] UINT32
The zero-based starting character position of a substring in this instance.
length
Type: [in] UINT32
The number of characters in the substring.
newString
Type: [out] HSTRING*
A string that is equivalent to the substring that begins at startIndex in string, or NULL if startIndex is equal to the length of string.
Return value
Type: HRESULT
This function can return one of these values.
| Return code | Description |
|---|---|
|
The substring was created successfully. |
|
newString is NULL, or startIndex plus length is greater than MAXUINT32, which is 4,294,967,295; that is, hexadecimal 0xFFFFFFFF. |
|
startIndex is greater than the length of string, or startIndex plus length indicates a position not within string. |
|
Failed to allocate the new substring. |
Remarks
Each call to the WindowsSubstringWithSpecifiedLength function must be matched with a corresponding call to WindowsDeleteString.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2012 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | winstring.h |
| Library | mincore.lib |