Funzione HttpDeleteServiceConfiguration (http.h)

Articolo
08/24/2023

La funzione HttpDeleteServiceConfiguration elimina i dati specificati, ad esempio indirizzi IP o certificati SSL, dall'archivio di configurazione dell'API del server HTTP, un record alla volta.

Sintassi

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

Parametri

[in] ServiceHandle

Questo parametro è riservato e deve essere zero.

[in] ConfigId

Tipo di configurazione. Questo parametro è uno dei valori nell'enumerazione HTTP_SERVICE_CONFIG_ID .

Valore ConfigId	Significato
HttpServiceConfigIPListenList	Elimina un indirizzo IP specificato dall'elenco di ascolti IP.
HttpServiceConfigSSLCertInfo	Elimina un record di certificato SSL specificato.
HttpServiceConfigUrlAclInfo	Elimina un record di prenotazione URL specificato.
HttpServiceConfigTimeout	Elimina un timeout di connessione specificato. Windows Vista e versioni successive: Questa enumerazione è supportata.
HttpServiceConfigSslSniCertInfo	Elimina un record di certificato SNI (Ssl Server Name Indication) specificato. Windows 8 e versioni successive: Questo valore di enumerazione è supportato.
HttpServiceConfigSslCcsCertInfo	Elimina 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 che contiene i dati necessari per il tipo di configurazione specificato nel parametro ConfigId .

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.
HttpServiceConfigTimeouts	HTTP_SERVICE_CONFIG_TIMEOUT_KEY 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

Riservato per un'operazione asincrona futura. Questo parametro deve essere impostato su NULL.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce NO_ERROR.

Se la funzione ha esito negativo, restituisce uno dei codici di errore seguenti.

Valore	Significato
ERROR_INVALID_PARAMETER	Uno dei parametri non è valido.
Altri	Codice di errore di sistema definito in WinError.h.

Requisiti


Client minimo supportato	Windows Vista, 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

HttpQueryServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration

Condividi tramite