Funzione HttpUpdateServiceConfiguration (http.h)

Articolo
08/24/2023

Aggiornamenti un parametro di configurazione del servizio che specifica un certificato TLS (Transport Layer Security) in un record di configurazione all'interno dell'archivio di configurazione dell'API HTTP.

Sintassi

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

Parametri

[in] Handle

Riservato e deve essere NULL.

[in] ConfigId

Tipo di record di configurazione da aggiornare. Questo parametro può essere uno dei valori seguenti dell'enumerazione HTTP_SERVICE_CONFIG_ID .

Valore ConfigId	Significato
HttpServiceConfigSSLCertInfo	Aggiornamenti un record di certificato SSL specificato.
HttpServiceConfigSslSniCertInfo	Aggiornamenti un record di certificato SNI (SSL Server Name Indication) specificato.
HttpServiceConfigSslCcsCertInfo	Aggiornamenti il record di certificato SSL che specifica che Http.sys deve consultare l'archivio archivi certificati centralizzati (CCS) per trovare i certificati se la porta riceve un handshake TLS. La porta viene specificata dal membro KeyDesc della struttura HTTP_SERVICE_CONFIG_SSL_CCS_SET passata al parametro pConfigInfo .

[in] ConfigInfo

Puntatore a un buffer che contiene i dati appropriati per specificare il tipo di record da aggiornare. Nella tabella seguente viene illustrato il tipo di dati che il buffer contiene per i diversi valori possibili del parametro ConfigId .

Valore ConfigId	Tipo di dati nel buffer pConfigInfo
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET struttura.
HttpServiceConfigSslSniCertInfo	HTTP_SERVICE_CONFIG_SSL_SNI_SET struttura. Il nome host sarà "*" quando viene eseguito una query nell'archivio certificati centrale SSL e vengono usate associazioni con caratteri jolly e un nome host per la normale SNI.
HttpServiceConfigSslCcsCertInfo	HTTP_SERVICE_CONFIG_SSL_CCS_SET struttura. Questa struttura viene utilizzata per aggiungere l'archivio CCS sulla porta specificata, nonché per eliminare, recuperare o aggiornare un record CCS SSL esistente.

[in] ConfigInfoLength

Dimensioni, in byte, del buffer ConfigInfo .

[in] Overlapped

Riservato e deve essere NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_FILE_NOT_FOUND	Il record specificato non esiste.
ERROR_INSUFFICIENT_BUFFER	Le dimensioni del buffer specificate nel parametro ConfigInfoLength non sono sufficienti.
ERROR_INVALID_HANDLE	Il parametro ServiceHandle non è valido.
ERROR_INVALID_PARAMETER	Uno o più dei parametri forniti sono in un formato inutilizzabile.
ERROR_NO_SUCH_LOGON_SESSION	Il certificato SSL usato non è valido. Ciò può verificarsi solo se viene usato il parametro HttpServiceConfigSSLCertInfo .
Altri	Codice di errore di sistema definito in WinError.h.

Commenti

I parametri di configurazione che si aggiornano con HttpUpdateServiceConfiguration vengono applicati a tutte le applicazioni API server HTTP nel computer e vengono mantenuti quando l'API server HTTP viene arrestata o quando il computer viene riavviato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 1703 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	http.h
Libreria	Httpapi.lib
DLL	Httpapi.dll