Método IGlobalRSCAQueryProvider::GetOutputBuffer

Cria uma nova BYTE matriz.

Sintaxe

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

Parâmetros

cbBuffer
[IN] Um DWORD que contém o número de bytes a serem alocados.

ppbBuffer
[OUT] Um ponteiro para uma BYTE matriz que contém o novo buffer.

Valor Retornado

Um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor	Definição
S_OK	Indica que a operação foi bem-sucedida.
E_OUTOFMEMORY	Indica que a memória do heap está esgotada.

Comentários

Classes derivadas de CGlobalModule que se registram para eventos GL_RSCA_QUERY recebem um ponteiro IGlobalRscaQueryProvider como um parâmetro no método CGlobalModule::OnGlobalRSCAQueryvirtual. Em seguida, você pode recuperar uma nova BYTE matriz chamando o GetOutputBuffer método no IGlobalRSCAQueryProvider ponteiro.

O GetOutputBuffer valor retornado depende da implementação. Você deve usar as seguintes informações como uma diretriz, mas elas podem não estar corretas em todos os cenários:

O IGlobalRSCAQueryProvider implementador declara um ponteiro privado BYTE como uma variável de membro chamada buffer; o implementador inicializa buffer para NULL na construção. Se buffer não for NULL quando GetOutputBuffer for chamado, a função LocalFree será chamada em buffer. A função LocalAlloc é chamada para atribuir buffer a uma nova BYTE matriz de tamanho cbBuffer no heap. buffer será retornado no parâmetro desreferenciado ppbBuffer se GetOutputBuffer retornar S_OK.

Importante Esse método faz parte da infraestrutura do IIS 7 e não se destina a ser usado diretamente do seu código.

Notas para implementadores

IGlobalRSCAQueryProvider os implementadores são responsáveis pelo gerenciamento de memória com esses dados; portanto, IGlobalRSCAQueryProvider os implementadores que usam alocação de memória dinâmica devem liberar ou chamar delete no BYTE ponteiro quando ele não for mais necessário.

Observações para chamadores

IGlobalRSCAQueryProvider os implementadores são responsáveis pelo gerenciamento de memória com esses dados; portanto, IGlobalRSCAQueryProvider os clientes não devem liberar ou chamar a exclusão no ponteiro retornado BYTE quando esses dados não forem mais necessários.

Requisitos

Type	Descrição
Cliente	- IIS 7.0 no Windows Vista - IIS 7.5 no Windows 7 - IIS 8.0 no Windows 8 - IIS 10.0 no Windows 10
Servidor	- IIS 7.0 no Windows Server 2008 - IIS 7.5 no Windows Server 2008 R2 - IIS 8.0 no Windows Server 2012 - IIS 8.5 no Windows Server 2012 R2 - IIS 10.0 no Windows Server 2016
Produto	- 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
parâmetro	Httpserv.h

Consulte Também

IGlobalRSCAQueryProvider Interface
Método IGlobalRSCAQueryProvider::ResizeOutputBuffer