Fonction WindowsDeleteStringBuffer (winstring.h)

Ignore une mémoire tampon de chaîne préallouée si elle n’a pas été promue en HSTRING.

Syntaxe

HRESULT WindowsDeleteStringBuffer(
  HSTRING_BUFFER bufferHandle
);

Paramètres

bufferHandle

Type : [in] HSTRING_BUFFER

Mémoire tampon à ignorer. La fonction WindowsDeleteStringBuffer lève une exception si bufferHandle n’a pas été alloué par un appel à la fonction WindowsPreallocateStringBuffer .

Valeur retournée

Type : HRESULT

Cette fonction peut retourner l’une de ces valeurs.

Remarques

Utilisez la fonction WindowsDeleteStringBuffer pour ignorer une mémoire tampon de chaîne qui a été créée par la fonction WindowsPreallocateStringBuffer mais qui n’a pas été promue en HSTRING par la fonction WindowsPromoteStringBuffer .

Exemples

L’exemple de code suivant montre comment utiliser la fonction WindowsDeleteStringBuffer .

int main()
{
    HSTRING_BUFFER hStringBuffer = NULL;
    PWSTR strBuffer = NULL;
    HRESULT hr = WindowsPreallocateStringBuffer(10, &strBuffer, &hStringBuffer);

    // You hit a case in which you need to discard the buffer.

    WindowsStringDeleteBuffer(hStringBuffer);
}

Configuration requise

Voir aussi

HSTRING

HSTRING_BUFFER

WindowsPreallocateStringBuffer

WindowsPromoteStringBuffer