Compartir a través de


Función WindowsReplaceString (winstring.h)

Reemplaza todas las apariciones de un conjunto de caracteres de la cadena especificada por otro conjunto de caracteres para crear una nueva cadena.

Syntax

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

Parámetros

string

Tipo: [in] HSTRING

Cadena original.

stringReplaced

Tipo: [in] HSTRING

Cadena que se va a reemplazar.

stringReplaceWith

Tipo: [in] HSTRING

Cadena que se va a reemplazar todas las apariciones de stringReplaced. Si este parámetro es NULL, se quitan todas las instancias de stringReplaced .

newString

Tipo: [out] HSTRING*

Cadena que es equivalente al original, excepto que todas las instancias de stringReplaced se reemplazan por stringReplaceWith.

Valor devuelto

Tipo: HRESULT

Esta función puede devolver uno de estos valores.

Código de retorno Description
S_OK
El reemplazo de cadena se realizó correctamente.
E_INVALIDARG
newString es NULL, stringReplaced está vacío o la longitud de string1 más la longitud de string2 es mayor que MAXUINT32, que es 4.294.967.295; es decir, 0xFFFFFFFF hexadecimal.
E_OUTOFMEMORY
No se pudo asignar la nueva cadena.

Observaciones

Cada llamada a la función WindowsReplaceString debe coincidir con una llamada correspondiente a WindowsDeleteString.

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo admitido Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de Windows
Header winstring.h
Library mincore.lib

Consulte también

WindowsDeleteString