IGlobalRSCAQueryProvider::GetOutputBuffer (Método)

Crea una nueva BYTE matriz.

Sintaxis

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

Parámetros

cbBuffer
[IN] que DWORD contiene el número de bytes que se van a asignar.

ppbBuffer
[OUT] Puntero a una BYTE matriz que contiene el nuevo búfer.

Valor devuelto

Una clase HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Value	Definición
S_OK	Indica que la operación se realizó correctamente.
E_OUTOFMEMORY	Indica que se agota la memoria del montón.

Comentarios

Las clases derivadas de CGlobalModule que se registran para eventos de GL_RSCA_QUERY reciben un puntero IGlobalRscaQueryProvider como parámetro en el método CGlobalModule::OnGlobalRSCAQueryvirtual. A continuación, puede recuperar una nueva BYTE matriz llamando al GetOutputBuffer método en el IGlobalRSCAQueryProvider puntero.

El GetOutputBuffer valor devuelto depende de la implementación. Debe usar la siguiente información como guía, pero puede que no sea correcta en todos los escenarios:

El IGlobalRSCAQueryProvider implementador declara un puntero privado BYTE como una variable miembro denominada buffer; el implementador se inicializa buffer en NULL en la construcción. Si buffer no es NULL cuando GetOutputBuffer se llama a , se llama a la función LocalFree en buffer. Se llama a la función LocalAlloc para asignar buffer a una nueva BYTE matriz de tamaño cbBuffer en el montón. buffer a continuación, se devuelve en el parámetro desreferenciado ppbBuffer si GetOutputBuffer devuelve S_OK.

Importante Este método forma parte de la infraestructura de IIS 7 y no está pensado para usarse directamente desde el código.

Notas para los implementadores

IGlobalRSCAQueryProvider Los implementadores son responsables de la administración de memoria con estos datos; por lo tanto, IGlobalRSCAQueryProvider los implementadores que usan la asignación de memoria dinámica deben liberarse o llamar delete al BYTE puntero cuando ya no sea necesario.

Notas para autores de la llamada

IGlobalRSCAQueryProvider Los implementadores son responsables de la administración de memoria con estos datos; Por lo tanto, IGlobalRSCAQueryProvider los clientes no deben liberar ni llamar a la eliminación en el puntero devuelto BYTE cuando estos datos ya no son necesarios.

Requisitos

Tipo	Descripción
Remoto	- IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10
Servidor	- IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016
Producto	- 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
Encabezado	Httpserv.h

Consulte también

IGlobalRSCAQueryProvider (Interfaz)
IGlobalRSCAQueryProvider::ResizeOutputBuffer (Método)