Fungsi WindowsDeleteStringBuffer (winstring.h)

Artikel
03/08/2023

Membuang buffer string yang telah dialokasikan sebelumnya jika tidak dipromosikan ke HSTRING.

Sintaks

HRESULT WindowsDeleteStringBuffer(
  HSTRING_BUFFER bufferHandle
);

Parameter

bufferHandle

Jenis: [in] HSTRING_BUFFER

Buffer yang akan dibuang. Fungsi WindowsDeleteStringBuffer menimbulkan pengecualian jika bufferHandle tidak dialokasikan oleh panggilan ke fungsi WindowsPreallocateStringBuffer .

Mengembalikan nilai

Jenis: HRESULT

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Buffer berhasil dibuang.
E_POINTER	bufferHandle adalah NULL.

Keterangan

Gunakan fungsi WindowsDeleteStringBuffer untuk membuang buffer string yang dibuat oleh fungsi WindowsPreallocateStringBuffer tetapi belum dipromosikan ke HSTRING oleh fungsi WindowsPromoteStringBuffer .

Catatan Memanggil WindowsPromoteStringBuffer setelah memanggil WindowsDeleteStringBuffer dengan handel buffer yang sama tidak terdefinisi.

Contoh

Contoh kode berikut menunjukkan cara menggunakan fungsi 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);
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winstring.h
Pustaka	RuntimeObject.lib
DLL	ComBase.dll