Metode IGlobalRSCAQueryProvider::GetOutputBuffer

Membuat array baru BYTE .

Sintaks

virtual HRESULT GetOutputBuffer(  
   DWORD cbBuffer,  
   OUT BYTE** ppbBuffer  
) = 0;  

Parameter

cbBuffer
[IN] DWORD yang berisi jumlah byte yang akan dialokasikan.

ppbBuffer
[OUT] Penunjuk ke BYTE array yang berisi buffer baru.

Tampilkan Nilai

Sebuah HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Nilai	Definisi
S_OK	Menunjukkan bahwa operasi berhasil.
E_OUTOFMEMORY	Menunjukkan bahwa memori tumpukan habis.

Keterangan

Kelas turunan CGlobalModule yang mendaftar untuk peristiwa GL_RSCA_QUERY menerima pointer IGlobalRscaQueryProvider sebagai parameter pada metode CGlobalModule::OnGlobalRSCAQueryvirtual . Anda kemudian dapat mengambil array baru BYTE dengan memanggil GetOutputBuffer metode pada pointer IGlobalRSCAQueryProvider .

Nilai GetOutputBuffer yang dikembalikan tergantung pada implementasi. Anda harus menggunakan informasi berikut sebagai pedoman, tetapi mungkin tidak benar dalam semua skenario:

Pelaksana IGlobalRSCAQueryProvider menyatakan pointer privat BYTE sebagai variabel anggota yang disebut buffer; pelaksana buffer menginisialisasi ke NULL saat konstruksi. Jika buffer bukan NULL ketika GetOutputBuffer dipanggil, fungsi LocalFree dipanggil pada buffer. Fungsi LocalAlloc dipanggil untuk menetapkan buffer ke array ukuran cbBuffer baru BYTE pada heap. buffer kemudian dikembalikan dalam parameter dereferensi ppbBuffer jika GetOutputBuffer mengembalikan S_OK.

Penting Metode ini adalah bagian dari infrastruktur IIS 7 dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.

Catatan untuk Pelaksana

IGlobalRSCAQueryProvider pelaksana bertanggung jawab atas manajemen memori dengan data ini; oleh karena itu, IGlobalRSCAQueryProvider pelaksana yang menggunakan alokasi memori dinamis harus melepaskan atau memanggil delete penunjuk BYTE ketika tidak lagi diperlukan.

Catatan untuk Penelepon

IGlobalRSCAQueryProvider pelaksana bertanggung jawab atas manajemen memori dengan data ini; oleh karena itu, IGlobalRSCAQueryProvider klien tidak boleh merilis atau memanggil penghapusan pada pointer yang dikembalikan BYTE ketika data ini tidak lagi diperlukan.

Persyaratan

Jenis	Deskripsi
Klien	- IIS 7.0 di Windows Vista - IIS 7.5 di Windows 7 - IIS 8.0 di Windows 8 - IIS 10.0 pada Windows 10
Server	- IIS 7.0 di Windows Server 2008 - IIS 7.5 di Windows Server 2008 R2 - IIS 8.0 di Windows Server 2012 - IIS 8.5 di Windows Server 2012 R2 - IIS 10.0 di Windows Server 2016
Produk	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
Header	Httpserv.h

Lihat juga

Antarmuka IGlobalRSCAQueryProvider
Metode IGlobalRSCAQueryProvider::ResizeOutputBuffer