Función HttpSetServerSessionProperty (http.h)

La función HttpSetServerSessionProperty establece una nueva propiedad de sesión de servidor o modifica una propiedad existente en la sesión de servidor especificada.

Sintaxis

HTTPAPI_LINKAGE ULONG HttpSetServerSessionProperty(
  [in] HTTP_SERVER_SESSION_ID ServerSessionId,
  [in] HTTP_SERVER_PROPERTY   Property,
  [in] PVOID                  PropertyInformation,
  [in] ULONG                  PropertyInformationLength
);

Parámetros

[in] ServerSessionId

Sesión de servidor para la que se establece la propiedad.

[in] Property

Miembro de la enumeración HTTP_SERVER_PROPERTY que describe el tipo de propiedad que se establece. Esto puede ser uno de los siguientes.

Propiedad	Significado
HttpServerStateProperty	Modifica o establece el estado de la sesión del servidor. El estado puede estar habilitado o deshabilitado; el estado predeterminado está habilitado.
HttpServerTimeoutsProperty	Modifica o establece los límites de tiempo de espera de la conexión de sesión del servidor.
HttpServerQosProperty	Modifica o establece la limitación de ancho de banda para la sesión del servidor. De forma predeterminada, la API de servidor HTTP no limita el ancho de banda. Nota Este valor se asigna a la estructura de HTTP_QOS_SETTING_INFO genérica con QosType establecido en HttpQosSettingTypeBandwidth.
HttpServerLoggingProperty	Habilita o deshabilita el registro de la sesión del servidor. Esta propiedad establece solo el W3C centralizado y el registro binario centralizado. De forma predeterminada, el registro no está habilitado.
HttpServerAuthenticationProperty	Habilita la autenticación del lado servidor en modo kernel para los esquemas de autenticación Básico, NTLM, Negotiate y Digest.
HttpServerExtendedAuthenticationProperty	Habilita la autenticación del lado servidor en modo kernel para el esquema de autenticación Kerberos.
HttpServerChannelBindProperty	Habilita la autenticación del lado servidor que usa un token de enlace de canal (CBT).

[in] PropertyInformation

Puntero al búfer que contiene los datos de propiedad.

pPropertyInformation apunta a una estructura de datos de propiedad, que se muestra en la tabla siguiente, en función de la propiedad establecida.

Propiedad	Estructura
HttpServerStateProperty	HTTP_STATE_INFO
HttpServerLoggingProperty	HTTP_LOGGING_INFO
HttpServerQosProperty	HTTP_QOS_SETTING_INFO
HttpServerTimeoutsProperty	HTTP_TIMEOUT_LIMIT_INFO
HttpServerAuthenticationProperty	HTTP_SERVER_AUTHENTICATION_INFO
HttpServerExtendedAuthenticationProperty	HTTP_SERVER_AUTHENTICATION_INFO
HttpServerChannelBindProperty	HTTP_CHANNEL_BIND_INFO

[in] PropertyInformationLength

Longitud, en bytes, del búfer al que apunta el parámetro pPropertyInformation .

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_INVALID_PARAMETER

El tipo de propiedad especificado en el parámetro Property no se admite para las sesiones de servidor. El parámetro pPropertyInformation es NULL. El parámetro PropertyInformationLength es cero. El parámetro ServerSessionId no contiene una sesión de servidor válida. La aplicación no tiene permiso para establecer las propiedades de sesión del servidor. Solo la aplicación que creó la sesión de servidor puede establecer las propiedades.

Comentarios

Las sesiones de servidor son contenedores de configuración de nivel superior para los datos de configuración que se aplican a todos los grupos de direcciones URL creados en ellos. La sesión del servidor se crea con HttpCreateServerSession.

El parámetro pPropertyInformation apunta a la estructura de configuración del tipo de propiedad que se establece. El parámetro PropertyInformationLength especifica el tamaño, en bytes, de la estructura de configuración. Por ejemplo, al establecer httpServerTimeoutsProperty , el parámetro pPropertyInformation debe apuntar a un búfer que sea al menos igual al tamaño de la estructura HTTP_TIMEOUT_LIMIT_INFO .

Requisitos

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