共用方式為

WindowsReplaceString 函式 (winstring.h)

  • 發行項

以另一組字元取代指定字串中所有出現的字元集，以建立新的字串。

語法

HRESULT WindowsReplaceString(
  HSTRING string,
  HSTRING stringReplaced,
  HSTRING stringReplaceWith,
  HSTRING *newString
);

參數

string

類型： [in] HSTRING

原始字串。

stringReplaced

類型： [in] HSTRING

要被取代的字串。

stringReplaceWith

類型： [in] HSTRING

要取代 所有出現的 stringReplaced 字串。 如果此參數為 Null，則會移除 stringReplaced 的所有實例。

newString

類型： [out] HSTRING*

與原始相等的字串，不同之處在于 stringReplaced 的所有實例都會取代為 stringReplaceWith。

傳回值

類型： HRESULT

此函式可以傳回其中一個值。

傳回碼 描述
S_OK
 字串取代成功。
E_INVALIDARG
 newString 是 Null、 stringReplaced 是空的，或者 string1 的長度加上 string2 的長度大於 MAXUINT32，也就是 4，294，967，295;也就是十六進位0xFFFFFFFF。
E_OUTOFMEMORY
 無法配置新的字串。

備註

每個 對 WindowsReplaceString 函式的呼叫都必須與 對應的 WindowsDeleteString呼叫進行比對。

規格需求

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

另請參閱

WindowsDeleteString