Función HttpSetServiceConfiguration (http.h)

  • Artículo

La función HttpSetServiceConfiguration crea y establece un registro de configuración para el almacén de configuración de la API de 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.

Sintaxis

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 configId Significado
HttpServiceConfigIPListenList
 Establece un registro en la lista de escucha 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 ancho de la API de HTTP especificado.

Windows Vista y versiones posteriores: Se admite este valor de enumeración.
HttpServiceConfigSslSniCertInfo
 Establece un registro de certificado especificado de indicación de nombre de servidor SSL (SNI).

Windows 8 y versiones posteriores: se admite este valor de enumeración.
HttpServiceConfigSslCcsCertInfo
 Establece el registro de certificado SSL que especifica que Http.sys debe consultar el 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: se admite este valor de enumeración.

[in] pConfigInformation

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

Valor configId Significado
HttpServiceConfigIPListenList

HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM estructura.
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: Se admite esta estructura.
HttpServiceConfigSslSniCertInfo

HTTP_SERVICE_CONFIG_SSL_SNI_SET estructura. 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: se admite esta estructura.
HttpServiceConfigSslCcsCertInfo

HTTP_SERVICE_CONFIG_SSL_CCS_SET estructura.

Windows 8 y versiones posteriores: se admite esta estructura.

[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.

Valor Significado
ERROR_ALREADY_EXISTS
 El registro especificado ya existe y debe eliminarse para que se vuelva a establecer su valor.
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.

Comentarios

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [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 1.0

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpUpdateServiceConfiguration