WindowsCreateStringReference, fonction (winstring.h)

Crée une référence de chaîne basée sur la chaîne spécifiée.

Syntaxe

HRESULT WindowsCreateStringReference(
  PCWSTR         sourceString,
  UINT32         length,
  HSTRING_HEADER *hstringHeader,
  HSTRING        *string
);

Paramètres

sourceString

Type : [in] PCWSTR

Chaîne terminée par null à utiliser comme source pour le nouveau HSTRING.

La valeur NULL représente la chaîne vide, si la valeur de longueur est 0. Doit être alloué sur le cadre de la pile.

length

Type : [in] UINT32

Longueur de sourceString, en caractères Unicode. Doit être 0 si sourceString a la valeur NULL. Si la valeur est supérieure à 0, sourceString doit avoir un caractère null de fin.

hstringHeader

Type : [out] HSTRING_HEADER*

Pointeur vers une structure utilisée par Windows Runtime pour identifier la chaîne en tant que référence de chaîne ou chaîne rapide.

string

Type : [out] HSTRING*

Pointeur vers la chaîne nouvellement créée ou NULL si une erreur se produit. Tout contenu existant dans la chaîne est remplacé. HSTRING est un type de handle standard.

Valeur retournée

Type : HRESULT

Cette fonction peut retourner l’une de ces valeurs.

Remarques

Utilisez la fonction WindowsCreateStringReference pour créer un HSTRING à partir d’une chaîne existante. Ce type de HSTRING est nommé une chaîne de passe rapide. Contrairement à un HSTRING créé par la fonction WindowsCreateString , la durée de vie de la mémoire tampon de stockage dans le nouveau HSTRING n’est pas gérée par Windows Runtime. L’appelant alloue sourceString sur le cadre de la pile, ainsi qu’un HSTRING_HEADER non initialisé, pour éviter une allocation de tas et éliminer le risque d’une fuite de mémoire. L’appelant doit s’assurer que sourceString et le contenu de hstringHeader restent inchangés pendant la durée de vie du HSTRING attaché.

Vous n’avez pas besoin d’appeler la fonction WindowsDeleteString pour annuler l’allocation d’un HSTRING rapide créé par la fonction WindowsCreateStringReference .

Pour créer un HSTRING vide, passez NULL pour sourceString et 0 pour la longueur.

Windows Runtime effectue le suivi d’une chaîne rapide à l’aide d’une structure HSTRING_HEADER , qui est retournée dans le paramètre hstringHeader out . Ne modifiez pas le contenu de la HSTRING_HEADER.

Spécifications

Voir aussi

windowsCreateString

WindowsDeleteString