Función WindowsDeleteStringBuffer (winstring.h)

Artículo
03/13/2024

Descarta un búfer de cadena asignado previamente si no se ha promocionado a un HSTRING.

Sintaxis

HRESULT WindowsDeleteStringBuffer(
  HSTRING_BUFFER bufferHandle
);

Parámetros

bufferHandle

Tipo: [in] HSTRING_BUFFER

Búfer que se va a descartar. La función WindowsDeleteStringBuffer genera una excepción si bufferHandle no se asignó mediante una llamada a la función WindowsPreallocateStringBuffer .

Valor devuelto

Tipo: HRESULT

Esta función puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El búfer se descartó correctamente.
E_POINTER	bufferHandle es NULL.

Comentarios

Use la función WindowsDeleteStringBuffer para descartar un búfer de cadena creado por la función WindowsPreallocateStringBuffer, pero que la función WindowsPromoteStringBuffer no ha promovido a un HSTRING por la función WindowsPromoteStringBuffer.

Nota Llamar a WindowsPromoteStringBuffer después de llamar a WindowsDeleteStringBuffer con el mismo identificador de búfer no está definido.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la función 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);
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	winstring.h
Library	RuntimeObject.lib
Archivo DLL	ComBase.dll