Função HttpCreateUrlGroup (http.h)

Artigo
08/24/2023

A função HttpCreateUrlGroup cria um Grupo de URLs na sessão de servidor especificada.

Sintaxe

HTTPAPI_LINKAGE ULONG HttpCreateUrlGroup(
  [in]  HTTP_SERVER_SESSION_ID ServerSessionId,
  [out] PHTTP_URL_GROUP_ID     pUrlGroupId,
  [in]  ULONG                  Reserved
);

Parâmetros

[in] ServerSessionId

O identificador da sessão do servidor na qual o Grupo de URL é criado.

[out] pUrlGroupId

Um ponteiro para a variável que recebe a ID do Grupo de URLs.

[in] Reserved

Reservado. Deve ser zero.

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 ServerSessionId indica uma sessão de servidor não existente. O parâmetro pUrlGroupId é nulo. O parâmetro Reserved é diferente de zero.

Valor

Significado

ERROR_INVALID_PARAMETER

O parâmetro ServerSessionId indica uma sessão de servidor não existente.

O parâmetro pUrlGroupId é nulo.

O parâmetro Reserved é diferente de zero.

Comentários

Grupos de URLs são contêineres de configuração para um conjunto de URLs. Eles são criados na sessão do servidor e herdam as definições de configuração da sessão do servidor. Quando um parâmetro de configuração é definido no Grupo de URLs, ele substitui o conjunto de configurações na sessão do servidor. Para obter mais informações sobre as configurações de configuração do Grupo de URL, consulte HttpSetUrlGroupProperty.

Depois que o grupo de URL é criado, ele deve ser associado a uma fila de solicitações para receber solicitações. Para associar o Grupo de URLs a uma fila de solicitações, o aplicativo chama HttpSetUrlGroupProperty com a propriedade HttpServerBindingProperty . Se essa propriedade não estiver definida, as solicitações correspondentes para o Grupo de URL não serão entregues a uma fila de solicitações e a API do Servidor HTTP gerará uma resposta 503.

A associação do grupo de URL com uma fila de solicitação é dinâmica. A associação com a sessão de servidores não pode ser alterada até que a sessão do servidor ou o Grupo de URL seja excluído. Quando uma sessão de servidor é excluída, todos os Grupos de URL associados também são fechados automaticamente.

O Grupo de URLs é criado inicialmente como um grupo vazio. As URLs devem ser adicionadas ao grupo chamando HttpAddUrlToUrlGroup.

O aplicativo pode criar vários grupos de URL pelos seguintes motivos:

Para definir configurações distintas para diferentes partes do espaço de nome da URL em que ele está escutando.
Para definir filas de solicitação separadas para diferentes partes do espaço de nome da URL em que ele está escutando.

Os aplicativos devem combinar URLs em grupos o máximo possível; caso contrário, o desempenho diminuirá e o aumento do consumo de memória do sistema afetará a escalabilidade.

A API do Servidor HTTP não dá suporte a E/S assíncrona em grupos de URL.

Quando o grupo de URL não for mais necessário ou antes que o aplicativo seja encerrado, ele deverá excluir o Grupo de URL chamando HttpCloseUrlGroup.

O Grupo de URLs é criado com a mesma versão da sessão do servidor na qual ele é criado.

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