Funzione HttpSetServiceConfiguration (http.h)

Articolo
02/27/2024

La funzione HttpSetServiceConfiguration crea e imposta un record di configurazione per l'archivio di configurazione dell'API del server HTTP. La chiamata ha esito negativo se il record specificato esiste già. Per modificare un determinato record di configurazione, eliminarlo e ricrearlo con un valore diverso.

Sintassi

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

Parametri

[in] ServiceHandle

Riservato. Deve essere zero.

[in] ConfigId

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

Valore ConfigId	Significato
HttpServiceConfigIPListenList	Imposta un record nell'elenco di ascolti IP.
HttpServiceConfigSSLCertInfo	Imposta un record di certificato SSL specificato.
HttpServiceConfigUrlAclInfo	Imposta un record di prenotazione URL.
HttpServiceConfigTimeout	Imposta un timeout di connessione a livello di API server HTTP specificato. Windows Vista e versioni successive: Questo valore di enumerazione è supportato.
HttpServiceConfigSslSniCertInfo	Imposta un record di certificato SNI (SSL Server Name Indication) specificato. Windows 8 e versioni successive: questo valore di enumerazione è supportato.
HttpServiceConfigSslCcsCertInfo	Imposta il record del certificato SSL che specifica che Http.sys deve consultare l'archivio certificati centralizzato (CCS) per trovare i certificati se la porta riceve un handshake Transport Layer Security (TLS). La porta viene specificata dal membro KeyDesc della struttura HTTP_SERVICE_CONFIG_SSL_CCS_SET passata al parametro pConfigInformation . Windows 8 e versioni successive: questo valore di enumerazione è supportato.

[in] pConfigInformation

Puntatore a un buffer contenente i dati appropriati per specificare il tipo di record da impostare.

Valore ConfigId	Significato
HttpServiceConfigIPListenList	HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM struttura.
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET struttura.
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_SET struttura.
HttpServiceConfigTimeout	HTTP_SERVICE_CONFIG_TIMEOUT_SET struttura. Windows Vista e versioni successive: Questa struttura è supportata.
HttpServiceConfigSslSniCertInfo	HTTP_SERVICE_CONFIG_SSL_SNI_SET struttura. Il nome host sarà "" quando viene eseguita una query sull'archivio certificati centrale SSL e vengono usati binding con caratteri jolly e un nome host per la normale SNI. Windows 8 e versioni successive:* questa struttura è supportata.
HttpServiceConfigSslCcsCertInfo	HTTP_SERVICE_CONFIG_SSL_CCS_SET struttura. Windows 8 e versioni successive: questa struttura è supportata.

[in] ConfigInformationLength

Dimensioni, in byte, del buffer pConfigInformation .

[in] pOverlapped

Questo parametro è riservato e deve essere NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

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

Valore	Significato
ERROR_ALREADY_EXISTS	Il record specificato esiste già e deve essere eliminato affinché il relativo valore venga riimpostati.
ERROR_INSUFFICIENT_BUFFER	Le dimensioni del buffer specificate nel parametro ConfigInformationLength non sono sufficienti.
ERROR_INVALID_HANDLE	Il parametro ServiceHandle non è valido.
ERROR_INVALID_PARAMETER	Uno o più parametri forniti sono in formato inutilizzabile.
ERROR_NO_SUCH_LOGON_SESSION	Il certificato SSL utilizzato non è valido. Questa situazione può verificarsi solo se viene usato il parametro HttpServiceConfigSSLCertInfo .
Altri	Codice di errore di sistema definito in WinError.h.

Commenti

I parametri di configurazione impostati con HttpSetServiceConfiguration 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 XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	http.h
Libreria	Httpapi.lib
DLL	Httpapi.dll

Vedi anche

Funzioni dell'API server HTTP versione 1.0

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpUpdateServiceConfiguration

Condividi tramite