Funzione HttpSetServiceConfiguration (http.h)

  • Articolo

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