Función HttpCreateServerSession (http.h)

  • Artículo

La función HttpCreateServerSession crea una sesión de servidor para la versión especificada.

Sintaxis

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

Parámetros

[in] Version

Estructura HTTPAPI_VERSION que indica la versión de la sesión del servidor. Para la versión 2.0, declare una instancia de la estructura y establézcala en el valor predefinido HTTPAPI_VERSION_2 antes de pasarla a HttpCreateServerSession.

La versión debe ser 2.0; HttpCreateServerSession no admite colas de solicitudes de la versión 1.0.

[out] ServerSessionId

Puntero a la variable que recibe el identificador de la sesión del servidor.

[in] Reserved

Reservado. Debe ser cero.

Valor devuelto

Si la función se realiza correctamente, devuelve NO_ERROR.

Si se produce un error en la función, devuelve uno de los siguientes códigos de error.

Valor Significado
ERROR_REVISION_MISMATCH
 La versión pasada no es válida o no es compatible.
ERROR_INVALID_PARAMETER
 El parámetro pServerSessionId es null o Reserved es distinto de cero.

Comentarios

Las sesiones de servidor poseen un conjunto de grupos de direcciones URL. Son contenedores de configuración de nivel superior para obtener información de configuración que se aplica a todos los grupos de direcciones URL creados en ellos. Para obtener más información sobre cómo configurar una sesión de servidor, vea HttpSetServerSessionProperty.

La API del servidor HTTP no admite E/S asincrónica para sesiones de servidor.

Cuando la sesión del servidor ya no es necesaria o antes de que finalice la aplicación, la aplicación debe eliminar la sesión del servidor llamando a HttpCloseServerSession. Cuando se elimina una sesión de servidor, todos los grupos de direcciones URL asociados también se eliminan automáticamente.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado http.h
Library Httpapi.lib
Archivo DLL Httpapi.dll

Consulte también

Funciones de la API de servidor HTTP versión 2.0

HttpCloseServerSession

HttpCreateServerSession

HttpQueryServerSessionProperty

HttpSetServerSessionProperty