Fonction WindowsDuplicateString (winstring.h)

  • Article

Crée une copie de la chaîne spécifiée.

Syntaxe

HRESULT WindowsDuplicateString(
  HSTRING string,
  HSTRING *newString
);

Paramètres

string

Type : [in] HSTRING

Chaîne à copier.

newString

Type : [out] HSTRING*

Copie de chaîne.

Valeur retournée

Type : HRESULT

Cette fonction peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
 Le HSTRING a été copié avec succès.
E_INVALIDARG
 newString a lavaleur NULL.
E_OUTOFMEMORY
 Échec de l’allocation du nouveau HSTRING.

Remarques

Utilisez la fonction WindowsDuplicateString pour copier un HSTRING. Si la chaîne a été créée en appelant la fonction WindowsCreateString , le nombre de références de la mémoire tampon de stockage est incrémenté. Si la chaîne a été créée en appelant la fonction WindowsCreateStringReference, l’Windows Runtime copie sa chaîne source dans une nouvelle mémoire tampon et démarre un nombre de références, ce qui signifie que newString n’est pas une chaîne de passe rapide.

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

Configuration requise

Condition requise Valeur
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

WindowsCreateString

WindowsCreateStringReference

WindowsDeleteString