Función WindowsReplaceString (winstring.h)

  • Artículo

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