Función HttpCreateServerSession (http.h)
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 |
|---|---|
|
La versión pasada no es válida o no es compatible. |
|
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