Share via

Fonction WindowsReplaceString (winstring.h)

  • Article

Remplace toutes les occurrences d’un jeu de caractères dans la chaîne spécifiée par un autre ensemble de caractères pour créer une chaîne.

Syntaxe

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

Paramètres

string

Type : [in] HSTRING

Chaîne d'origine.

stringReplaced

Type : [in] HSTRING

Chaîne à remplacer.

stringReplaceWith

Type : [in] HSTRING

Chaîne pour remplacer toutes les occurrences de stringReplaced. Si ce paramètre a la valeur NULL, toutes les instances de stringReplaced sont supprimées.

newString

Type : [out] HSTRING*

Chaîne équivalente à l’original, sauf que toutes les instances de stringReplaced sont remplacées par stringReplaceWith.

Valeur retournée

Type : HRESULT

Cette fonction peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
 Le remplacement de chaîne a réussi.
E_INVALIDARG
 newString a la valeur NULL, stringReplaced est vide ou la longueur de string1 plus la longueur de string2 est supérieure à MAXUINT32, soit 4 294 967 295 ; c’est-à-dire 0xFFFFFFFF hexadécimal.
E_OUTOFMEMORY
 Échec de l’allocation de la nouvelle chaîne.

Remarques

Chaque appel à la fonction WindowsReplaceString doit être mis en correspondance avec un appel correspondant à WindowsDeleteString.

Configuration requise

   
Client minimal pris en charge Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête winstring.h

Voir aussi

WindowsDeleteString