Partager via


Fonction WindowsDuplicateString (winstring.h)

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 Descriptif
S_OK
Le HSTRING a été copié avec succès.
E_INVALIDARG
newString a la valeur 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 , 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 pass rapide.

Chaque appel à la fonction WindowsDuplicateString 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

windowsCreateString

WindowsCreateStringReference

WindowsDeleteString