Fonction WindowsGetStringRawBuffer (winstring.h)

Récupère la mémoire tampon de stockage pour la chaîne spécifiée.

Syntaxe

PCWSTR WindowsGetStringRawBuffer(
  HSTRING string,
  UINT32  *length
);

Paramètres

string

Type : [in, facultatif] HSTRING

Chaîne facultative pour laquelle la mémoire tampon de stockage doit être récupérée. Peut être NULL.

length

Type : [out, facultatif] UINT32 *

Pointeur facultatif vers un UINT32. Si la valeur NULL est transmise pour la longueur, elle est ignorée. Si la longueur est un pointeur valide vers un UINT32 et si la chaîne est un HSTRING valide, la fonction définit la valeur pointée par la longueur sur le nombre de caractères Unicode dans la mémoire tampon de stockage pour la chaîne (y compris les caractères null incorporés, mais à l’exclusion de la valeur Null de fin). Si la longueur est un pointeur valide vers un UINT32 et que la chaîne a la valeur NULL, la valeur pointée par la longueur est définie sur 0.

Valeur retournée

Type : PCWSTR

Pointeur vers la mémoire tampon qui fournit le magasin de stockage pour la chaîne, ou la chaîne vide si la chaîne a la valeur NULL ou la chaîne vide.

Remarques

Utilisez la fonction WindowsGetStringRawBuffer pour obtenir un pointeur vers la mémoire tampon de stockage d’un HSTRING.

Ne modifiez pas le contenu de la mémoire tampon : un HSTRING doit être immuable.

Configuration requise