Función HttpUpdateServiceConfiguration (http.h)

Artículo
08/24/2023

Novedades de forma atómica un parámetro de configuración de servicio que especifica un certificado de seguridad de la capa de transporte (TLS) en un registro de configuración dentro del almacén de configuración de la API de servidor HTTP.

Sintaxis

HTTPAPI_LINKAGE ULONG HttpUpdateServiceConfiguration(
  [in] HANDLE                 Handle,
  [in] HTTP_SERVICE_CONFIG_ID ConfigId,
  [in] PVOID                  ConfigInfo,
  [in] ULONG                  ConfigInfoLength,
  [in] LPOVERLAPPED           Overlapped
);

Parámetros

[in] Handle

Reservado y debe ser NULL.

[in] ConfigId

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

Valor configId	Significado
HttpServiceConfigSSLCertInfo	Novedades un registro de certificado SSL especificado.
HttpServiceConfigSslSniCertInfo	Novedades un registro de certificado de indicación de nombre de servidor SSL (SNI) especificado.
HttpServiceConfigSslCcsCertInfo	Novedades 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 TLS. El puerto se especifica mediante el miembro KeyDesc de la estructura HTTP_SERVICE_CONFIG_SSL_CCS_SET que se pasa al parámetro pConfigInfo .

[in] ConfigInfo

Puntero a un búfer que contiene los datos adecuados para especificar el tipo de registro que se va a actualizar. En la tabla siguiente se muestra el tipo de datos que contiene el búfer para los distintos valores posibles del parámetro ConfigId .

Valor configId	Tipo de datos en el búfer pConfigInfo
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET 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.
HttpServiceConfigSslCcsCertInfo	HTTP_SERVICE_CONFIG_SSL_CCS_SET estructura. Esta estructura se usa para agregar el almacén CCS en el puerto especificado, así como para eliminar, recuperar o actualizar un registro CCS SSL existente.

[in] ConfigInfoLength

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

[in] Overlapped

Reservado y debe ser NULL.

Valor devuelto

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

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

Valor	Significado
ERROR_FILE_NOT_FOUND	El registro especificado no existe.
ERROR_INSUFFICIENT_BUFFER	El tamaño del búfer especificado en el parámetro ConfigInfoLength 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 que se actualizan con HttpUpdateServiceConfiguration 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 10, versión 1703 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	http.h
Library	Httpapi.lib
Archivo DLL	Httpapi.dll