共用方式為

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 呼叫進行比對。

規格需求

需求 值
最低支援的用戶端 Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 winstring.h

另請參閱

WindowsDeleteString