Partager via


WindowsReplaceString, fonction (winstring.h)

Remplace toutes les occurrences d’un jeu de caractères dans la chaîne spécifiée par un autre jeu 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 à 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 Descriptif
S_OK
Le remplacement de chaîne a réussi.
E_INVALIDARG
newString est NULL, stringReplaced est vide, ou la longueur de chaîne1 plus la longueur de chaîne2 est supérieure à MAXUINT32, soit 4 294 967 295 ; c’est-à-dire hexadécimal 0xFFFFFFFF.
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.

Spécifications

Requirement Valeur
Client minimum requis Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
plateforme cible Fenêtres
Header winstring.h
Library mincore.lib

Voir aussi

WindowsDeleteString