Controle de versão (API do servidor HTTP)

A API do SERVIDOR HTTP versão 2.0 torna obsoletas as filas de solicitação e as associações de URL da versão 1.0 com a fila de solicitações. O controle de versão no escopo do objeto permite que os aplicativos forneçam informações de versão específicas do aplicativo. Um aplicativo pode chamar automaticamente a versão correta das estruturas para o sistema operacional no qual está em execução.

Filas de solicitação

A partir da API do SERVIDOR HTTP versão 2.0, as filas de solicitação são criadas com HttpCreateRequestQueue tornando obsoleta a função HttpCreateHttpHandle versão 1.0. Os grupos de URL são introduzidos na versão 2.0 com a função HttpCreateUrlGroup . As URLs são adicionadas ao grupo usando HttpAddUrlToUrlGroup , o que torna obsoleta a função HttpAddUrl versão 1.0. Os grupos de URLs da versão 2.0 não devem ser usados com filas de solicitação da versão 1.0.

A partir da versão 2.0, as seguintes funções da versão 1.0 são obsoletas e não podem ser usadas com filas de solicitação da versão 2.0:

Para obter mais informações sobre como configurar grupos de URLs, consulte o tópico Configurando o grupo de URLs . Para obter mais informações sobre as filas de solicitação da versão 2.0, consulte o tópico Fila de Solicitações Nomeadas .

controle de versão Object-Scoped

Na versão 1.0, o aplicativo fornece a versão da API do servidor HTTP na chamada para HttpInitialize. As informações de versão são aceitas somente do primeiro aplicativo chamado HttpInitialize e são aplicadas a todos os aplicativos de API do servidor HTTP no mesmo processo. A partir da API versão 2.0, as informações de versão global fornecidas na chamada para HttpInitialize não são usadas. Para aplicativos da versão 2.0, a versão da API do servidor HTTP é passada no parâmetro Version quando a fila de solicitação ou sessão do servidor é criada por HttpCreateRequestQueue ou HttpCreateServerSession. Quando a fila de solicitação é criada com a versão 1.0 HttpCreateHttpHandle, ela é marcada automaticamente como versão 1.0. Os aplicativos versão 1.0 e versão 2.0 podem ser executados no mesmo processo.

As estruturas HTTP_REQUEST e HTTP_RESPONSE são atualizadas para incluir informações de autenticação na API do SERVIDOR HTTP versão 2.0. HTTP_REQUEST_V1 e HTTP_REQUEST_V2 são específicos para a versão da API usada pelo aplicativo. No entanto, os aplicativos não devem usar essas estruturas diretamente em seu código; em vez disso, eles devem usar HTTP_REQUEST para obter a versão correta com base na versão da fila de solicitação na qual a solicitação foi recebida. Além disso, lembre-se de que o tamanho da estrutura de HTTP_REQUEST é baseado na versão do sistema operacional sob a qual o código é compilado.