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.

Sintaxis

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 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 devuelto	Descripción
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.

Comentarios

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

Requisitos

Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	winstring.h

Consulte también

WindowsDeleteString