Função HttpAddUrlToUrlGroup (http.h)

Artigo
02/26/2024

A função HttpAddUrlToUrlGroup adiciona a URL especificada ao Grupo de URL identificado pela ID do Grupo de URL.

Essa função substitui a função HTTP versão 1.0 HttpAddUrl .

Sintaxe

HTTPAPI_LINKAGE ULONG HttpAddUrlToUrlGroup(
  [in]           HTTP_URL_GROUP_ID UrlGroupId,
  [in]           PCWSTR            pFullyQualifiedUrl,
  [in, optional] HTTP_URL_CONTEXT  UrlContext,
  [in]           ULONG             Reserved
);

Parâmetros

[in] UrlGroupId

A ID do grupo para o grupo de URL para o qual as solicitações para a URL especificada são roteadas. O grupo de URL é criado pela função HttpCreateUrlGroup .

[in] pFullyQualifiedUrl

Um ponteiro para uma cadeia de caracteres Unicode que contém uma Cadeia de Caracteres UrlPrefix formada corretamente que identifica a URL a ser registrada. Se você não estiver executando como administrador, especifique um número de porta maior que 1024, caso contrário, poderá receber um erro ERROR_ACCESS_DENIED.

[in, optional] UrlContext

O contexto associado à URL registrada nesta chamada. O contexto de URL é retornado na estrutura HTTP_REQUEST com cada solicitação recebida na URL especificada no parâmetro pFullyQualifiedUrl .

[in] Reserved

Reservado. Deve ser zero.

Retornar valor

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 UrlGroupId não existe. O parâmetro Reserved não é zero. O aplicativo não tem permissão para adicionar URLs ao Grupo. Somente o aplicativo que criou o Grupo de URL pode adicionar URLs.
ERROR_ACCESS_DENIED	O processo de chamada não tem permissão para registrar a URL.
ERROR_ALREADY_EXISTS	A URL especificada entra em conflito com um registro existente.

Valor

Significado

ERROR_INVALID_PARAMETER

O UrlGroupId não existe.

O parâmetro Reserved não é zero.

O aplicativo não tem permissão para adicionar URLs ao Grupo. Somente o aplicativo que criou o Grupo de URL pode adicionar URLs.

ERROR_ACCESS_DENIED

O processo de chamada não tem permissão para registrar a URL.

ERROR_ALREADY_EXISTS

A URL especificada entra em conflito com um registro existente.

Comentários

A API do servidor HTTP dá suporte a aplicativos existentes usando registros de URL da versão 1.0, no entanto, o novo desenvolvimento com a API do servidor HTTP deve usar HttpAddUrlToUrlGroup; HttpAddUrl não deve ser usado.

Um aplicativo pode adicionar várias URLs a um grupo de URL usando chamadas repetidas para HttpAddUrlToUrlGroup. As solicitações que correspondem à URL especificada são roteadas para a fila de solicitação associada ao grupo de URL. Para obter mais informações sobre como a API do Servidor HTTP corresponde às URLs de solicitação às URLs registradas, consulte Cadeias de caracteres urlPrefix.

Requisitos

Requisito	Valor
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