WindowsGetStringRawBuffer, fonction (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, optional] HSTRING

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

length

Type : [out, optional] UINT32 *

Pointeur facultatif vers un UINT32. Si la valeur NULL est passée pour la longueur, elle est ignorée. Si la longueur est un pointeur valide vers un UINT32 et que la chaîne est un HSTRING valide, la fonction définit la valeur pointée par 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 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 est 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.

Spécifications