Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 |
|---|---|
|
El reemplazo de cadena se realizó correctamente. |
|
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. |
|
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 |