Metodo IGlobalRSCAQueryProvider::GetOutputBuffer

Crea una nuova BYTE matrice.

Sintassi

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

Parametri

cbBuffer
[IN] Oggetto DWORD contenente il numero di byte da allocare.

ppbBuffer
[OUT] Puntatore a una BYTE matrice che contiene il nuovo buffer.

Valore restituito

Oggetto HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

valore	Definizione
S_OK	Indica che l'operazione ha avuto esito positivo.
E_OUTOFMEMORY	Indica che la memoria heap è esaurita.

Commenti

Le classi derivate CGlobalModule che registrano per gli eventi GL_RSCA_QUERY ricevono un puntatore IGlobalRscaQueryProvider come parametro nel metodo CGlobalModule::OnGlobalRSCAQueryvirtual. È quindi possibile recuperare una nuova BYTE matrice chiamando il GetOutputBuffer metodo sul IGlobalRSCAQueryProvider puntatore.

Il GetOutputBuffer valore restituito dipende dall'implementazione. È consigliabile usare le informazioni seguenti come linee guida, ma potrebbe non essere corretta in tutti gli scenari:

L'implementer IGlobalRSCAQueryProvider dichiara un puntatore privato come variabile membro BYTE denominato buffer; l'implementazione inizializza buffer in NULL in fase di costruzione. Se buffer non è NULL quando GetOutputBuffer viene chiamato, la funzione LocalFree viene chiamata su buffer. La funzione LocalAlloc viene chiamata per assegnare buffer a una nuova BYTE matrice di dimensioni cbBuffer nell'heap. buffer viene quindi restituito nel parametro dereferenced ppbBuffer se GetOutputBuffer restituisce S_OK.

Importante Questo metodo fa parte dell'infrastruttura IIS 7 e non deve essere usato direttamente dal codice.

Note per gli implementatori

IGlobalRSCAQueryProvider gli implementatori sono responsabili della gestione della memoria con questi dati; pertanto, IGlobalRSCAQueryProvider gli implementatori che usano l'allocazione dinamica della memoria devono rilasciare o chiamare delete il BYTE puntatore quando non è più necessario.

Note per i chiamanti

IGlobalRSCAQueryProvider gli implementatori sono responsabili della gestione della memoria con questi dati; pertanto, IGlobalRSCAQueryProvider i client non devono rilasciare o chiamare l'eliminazione sul puntatore restituito BYTE quando questi dati non sono più necessari.

Requisiti

Tipo	Descrizione
Client	- IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10
Server	- IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016
Prodotto	- 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
Intestazione	Httpserv.h

Vedere anche

Interfaccia IGlobalRSCAQueryProvider
Metodo IGlobalRSCAQueryProvider::ResizeOutputBuffer