Compartilhar via

Função WindowsReplaceString (winstring.h)

  • Artigo

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 retornado

Tipo: HRESULT

Essa função pode retornar um desses valores.

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

Comentários

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

Requisitos

   
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho winstring.h

Confira também

WindowsDeleteString