Função HttpCreateUrlGroup (http.h)
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 |
|---|---|
|
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 |