Función HttpSetServiceConfiguration (http.h)

La función HttpSetServiceConfiguration crea y establece un registro de configuración para el almacén de configuración de la API del servidor HTTP. Se produce un error en la llamada si el registro especificado ya existe. Para cambiar un registro de configuración determinado, elimínelo y vuelva a crearlo con un valor diferente.

Syntax

HTTPAPI_LINKAGE ULONG HttpSetServiceConfiguration(
  [in] HANDLE                 ServiceHandle,
  [in] HTTP_SERVICE_CONFIG_ID ConfigId,
  [in] PVOID                  pConfigInformation,
  [in] ULONG                  ConfigInformationLength,
  [in] LPOVERLAPPED           pOverlapped
);

Parámetros

[in] ServiceHandle

Reservado. Debe ser cero.

[in] ConfigId

Tipo de registro de configuración que se va a establecer. Este parámetro puede ser uno de los siguientes valores de la enumeración HTTP_SERVICE_CONFIG_ID .

Valor de ConfigId	Meaning
HttpServiceConfigIPListenList	Establece un registro en la lista de escucha de IP.
HttpServiceConfigSSLCertInfo	Establece un registro de certificado SSL especificado.
HttpServiceConfigUrlAclInfo	Establece un registro de reserva de direcciones URL.
HttpServiceConfigTimeout	Establece un tiempo de espera de conexión amplio de la API del servidor HTTP especificado. Windows Vista y versiones posteriores: Este valor de enumeración se admite.
HttpServiceConfigSslSniCertInfo	Establece un registro de certificado de indicación de nombre de servidor SSL (SNI) especificado. Windows 8 y versiones posteriores: Este valor de enumeración se admite.
HttpServiceConfigSslCcsCertInfo	Establece el registro de certificado SSL que especifica que Http.sys debe consultar el almacén del almacén de certificados centralizado (CCS) para buscar certificados si el puerto recibe un protocolo de enlace de seguridad de la capa de transporte (TLS). El puerto se especifica mediante el miembro KeyDesc de la estructura HTTP_SERVICE_CONFIG_SSL_CCS_SET que se pasa al parámetro pConfigInformation . Windows 8 y versiones posteriores: Este valor de enumeración se admite.

[in] pConfigInformation

Puntero a un búfer que contiene los datos adecuados para especificar el tipo de registro que se va a establecer.

Valor de ConfigId	Meaning
HttpServiceConfigIPListenList	estructura HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM .
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET estructura.
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_SET estructura.
HttpServiceConfigTimeout	HTTP_SERVICE_CONFIG_TIMEOUT_SET estructura. Windows Vista y versiones posteriores: Esta estructura es compatible.
HttpServiceConfigSslSniCertInfo	estructura HTTP_SERVICE_CONFIG_SSL_SNI_SET . El nombre de host será "*" cuando se consulte el almacén de certificados central SSL y se usen enlaces comodín y un nombre de host para SNI normal. Windows 8 y versiones posteriores: Esta estructura es compatible.
HttpServiceConfigSslCcsCertInfo	estructura de HTTP_SERVICE_CONFIG_SSL_CCS_SET . Windows 8 y versiones posteriores: Esta estructura es compatible.

[in] ConfigInformationLength

Tamaño, en bytes, del búfer pConfigInformation .

[in] pOverlapped

Este parámetro está reservado y debe ser NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Importancia	Meaning
ERROR_ALREADY_EXISTS	El registro especificado ya existe y debe eliminarse para que su valor se vuelva a establecer.
ERROR_INSUFFICIENT_BUFFER	El tamaño del búfer especificado en el parámetro ConfigInformationLength no es suficiente.
ERROR_INVALID_HANDLE	El parámetro ServiceHandle no es válido.
ERROR_INVALID_PARAMETER	Uno o varios de los parámetros proporcionados están en forma inutilizable.
ERROR_NO_SUCH_LOGON_SESSION	El certificado SSL usado no es válido. Esto solo puede ocurrir si se usa el parámetro HttpServiceConfigSSLCertInfo .
Otros	Código de error del sistema definido en WinError.h.

Observaciones

Los parámetros de configuración establecidos con HttpSetServiceConfiguration se aplican a todas las aplicaciones de API del servidor HTTP del equipo y se conservan cuando se cierra la API del servidor HTTP o cuando se reinicia el equipo.

Requisitos

Requirement	Importancia
Cliente mínimo compatible	Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
Header	http.h
Library	Httpapi.lib
DLL de	Httpapi.dll

Consulte también

Funciones de LA API de servidor HTTP versión 1.0

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpUpdateServiceConfiguration