Função HttpCreateServerSession (http.h)
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 |
|---|---|
|
A versão passada é inválida ou sem suporte. |
|
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