Compartilhar via

Função WindowsReplaceString (winstring.h)

Substitui todas as ocorrências de um conjunto de caracteres na cadeia de caracteres especificada por outro conjunto de caracteres para criar uma nova cadeia de caracteres.

Sintaxe

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

Parâmetros

string

Tipo: [in] HSTRING

A cadeia de caracteres original.

stringReplaced

Tipo: [in] HSTRING

A cadeia de caracteres a ser substituída.

stringReplaceWith

Tipo: [in] HSTRING

A cadeia de caracteres para substituir todas as ocorrências de stringReplaced. Se esse parâmetro for NULL, todas as instâncias de stringReplaced serão removidas.

newString

Tipo: [out] HSTRING*

Uma cadeia de caracteres equivalente ao original, exceto que todas as instâncias de stringReplaced são substituídas por stringReplaceWith.

Valor de retorno

Tipo: HRESULT

Essa função pode retornar um desses valores.

Código de retorno Description
S_OK
 A substituição da cadeia de caracteres foi bem-sucedida.
E_INVALIDARG
 newString é NULL, stringReplaced está vazio ou o comprimento da cadeia de caracteres1 mais o comprimento da cadeia de caracteres2 é maior que MAXUINT32, que é 4.294.967.295; ou seja, 0xFFFFFFFF hexadecimal.
E_OUTOFMEMORY
 Falha ao alocar a nova cadeia de caracteres.

Observações

Cada chamada para a função WindowsReplaceString deve ser correspondida com uma chamada correspondente para WindowsDeleteString.

Requirements

Requirement Value
Cliente mínimo suportado Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino Windows
Header winstring.h
Library mincore.lib

Consulte também

WindowsDeleteString

  • Last updated on