Funzione WindowsDeleteStringBuffer (winstring.h)

Articolo
03/04/2024

Rimuove un buffer di stringhe preallocato se non è stato promosso a un HSTRING.

Sintassi

HRESULT WindowsDeleteStringBuffer(
  HSTRING_BUFFER bufferHandle
);

Parametri

bufferHandle

Tipo: [in] HSTRING_BUFFER

Buffer da eliminare. La funzione WindowsDeleteStringBuffer genera un'eccezione se bufferHandle non è stato allocato da una chiamata alla funzione WindowsPreallocateStringBuffer .

Valore restituito

Tipo: HRESULT

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il buffer è stato rimosso correttamente.
E_POINTER	bufferHandle è NULL.

Commenti

Usare la funzione WindowsDeleteStringBuffer per eliminare un buffer stringa creato dalla funzione WindowsPreallocateStringBuffer ma non è stato promosso a HSTRING dalla funzione WindowsPromoteStringBuffer .

Nota La chiamata a WindowsPromoteStringBuffer dopo aver chiamato WindowsDeleteStringBuffer con lo stesso handle di buffer non è definita.

Esempio

Nell'esempio di codice seguente viene illustrato come usare la funzione 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);
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	winstring.h
Libreria	RuntimeObject.lib
DLL	ComBase.dll