Função HttpShutdownRequestQueue (http.h)

  • Artigo

A função HttpShutdownRequestQueue para de enfileirar solicitações para o processo de fila de solicitação especificado. Chamadas pendentes para HttpReceiveHttpRequest são canceladas.

Sintaxe

HTTPAPI_LINKAGE ULONG HttpShutdownRequestQueue(
  [in] HANDLE RequestQueueHandle
);

Parâmetros

[in] RequestQueueHandle

O identificador para a fila de solicitação que está desligada. Uma fila de solicitação é criada e seu identificador retornado por uma chamada para a função HttpCreateRequestQueue .

Valor retornado

Se a função for bem-sucedida, ela retornará NO_ERROR

Se a função falhar, ela retornará um dos seguintes códigos de erro.

Valor Significado
ERROR_INVALID_PARAMETER
 O parâmetro ReqQueueHandle não contém uma fila de solicitação válida.

O aplicativo não tem permissão para desligar a fila de solicitação.

Comentários

HttpShutdownRequestQueue cancela solicitações pendentes e interrompe todo o processamento no processo de fila de solicitação. As seguintes etapas são executadas quando essa função é chamada:

  1. O processo de fila de solicitação está marcado para limpeza e nenhuma nova solicitação é roteada para o processo de fila de solicitação.
  2. Se o processo de chamada for um controlador, as chamadas HttpWaitForDemandStart pendentes serão canceladas.
  3. As chamadas HttpReceiveHttpRequest pendentes do processo de chamada são canceladas.
  4. As solicitações que já estão associadas ao processo de chamada são canceladas.
  5. As solicitações pendentes não concebidas que são enfileiradas no processo de fila de solicitação redirecionadas para outro processo de fila de solicitação. Se nenhum outro processo de fila de solicitação estiver disponível, as solicitações pendentes serão salvas até que a fila de solicitações seja fechada ou outro processo de fila de solicitação não controlador seja iniciado.
  6. As chamadas httpWaitForDisconnect pendentes iniciadas pelo processo de chamada são canceladas.
  7. As respostas pendentes indicadas pelo processo de chamada não são afetadas, elas são concluídas corretamente.

Lembre-se de que, se o identificador da fila de solicitação for compartilhado por vários processos, HttpShutdownRequestQueue limitará a limpeza ao processo de chamada. Outros processos que trabalham atualmente na fila de solicitações não são afetados.

HttpShutdownRequestQueue pode ser usado por aplicativos para reciclar processos de fila de solicitação. Para essa finalidade, HttpShutdownRequestQueue é chamado antes de encerrar um processo que compartilha a fila de solicitações com outros processos. Depois que HttpShutdownRequestQueue retornar, o processo poderá ser encerrado ou reciclado com segurança.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho http.h
Biblioteca Httpapi.lib
DLL Httpapi.dll

Confira também

Funções da API do Servidor HTTP versão 2.0

HttpCloseRequestQueue

HttpCreateRequestQueue

HttpQueryRequestQueueProperty

HttpSetRequestQueueProperty