Função HttpCreateServerSession (http.h)

  • Artigo

A função HttpCreateServerSession cria uma sessão de servidor para a versão especificada.

Sintaxe

HTTPAPI_LINKAGE ULONG HttpCreateServerSession(
  [in]  HTTPAPI_VERSION         Version,
  [out] PHTTP_SERVER_SESSION_ID ServerSessionId,
  [in]  ULONG                   Reserved
);

Parâmetros

[in] Version

Uma estrutura HTTPAPI_VERSION que indica a versão da sessão do servidor. Para a versão 2.0, declare uma instância da estrutura e defina-a como o valor predefinido HTTPAPI_VERSION_2 antes de passá-la para HttpCreateServerSession.

A versão deve ser 2.0; HttpCreateServerSession não dá suporte a filas de solicitação da versão 1.0.

[out] ServerSessionId

Um ponteiro para a variável que recebe a ID da sessão do servidor.

[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_REVISION_MISMATCH
 A versão passada é inválida ou sem suporte.
ERROR_INVALID_PARAMETER
 O parâmetro pServerSessionId é nulo ou Reservado não é zero.

Comentários

As sessões de servidor possuem um conjunto de Grupos de URL. Eles são contêineres de configuração de nível superior para informações de configuração que se aplicam a todos os Grupos de URL criados sob eles. Para obter mais informações sobre como configurar uma sessão de servidor, consulte HttpSetServerSessionProperty.

A API do servidor HTTP não dá suporte a E/S assíncrona para sessões de servidor.

Quando a sessão do servidor não for mais necessária ou antes que o aplicativo seja encerrado, o aplicativo deverá excluir a sessão do servidor chamando HttpCloseServerSession. Quando uma sessão de servidor é excluída, todos os Grupos de URL associados também são excluídos automaticamente.

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

HttpCloseServerSession

HttpCreateServerSession

HttpQueryServerSessionProperty

HttpSetServerSessionProperty