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 | Description |
|---|---|
|
Le HSTRING a été copié avec succès. |
|
newString a lavaleur NULL. |
|
É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 |