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 的相应调用匹配。