HttpDeleteServiceConfiguration-Funktion (http.h)

  • Artikel

Die HttpDeleteServiceConfiguration-Funktion löscht die angegebenen Daten, z. B. IP-Adressen oder SSL-Zertifikate, aus dem HTTP-Server-API-Konfigurationsspeicher, jeweils einen Datensatz.

Syntax

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

Parameter

[in] ServiceHandle

Dieser Parameter ist reserviert und muss null sein.

[in] ConfigId

Typ der Konfiguration. Dieser Parameter ist einer der Werte in der HTTP_SERVICE_CONFIG_ID-Enumeration .

ConfigId-Wert Bedeutung
HttpServiceConfigIPListenList
 Löscht eine angegebene IP-Adresse aus der IP-Listenliste.
HttpServiceConfigSSLCertInfo
 Löscht einen angegebenen SSL-Zertifikatdatensatz.
HttpServiceConfigUrlAclInfo
 Löscht einen angegebenen URL-Reservierungsdatensatz.
HttpServiceConfigTimeout
 Löscht ein angegebenes Verbindungstimeout.

Windows Vista und höher: Diese Enumeration wird unterstützt.
HttpServiceConfigSslSniCertInfo
 Löscht einen angegebenen SSL Server Name Indication (SNI)-Zertifikatdatensatz.

Windows 8 und höher: Dieser Enumerationswert wird unterstützt.
HttpServiceConfigSslCcsCertInfo
 Löscht den SSL-Zertifikateintrag, der angibt, dass Http.sys den CCS-Speicher (Centralized Certificate Store) konsultieren sollten, um Zertifikate zu finden, wenn der Port einen TLS-Handshake (Transport Layer Security) empfängt. Der Port wird vom KeyDesc-Member der HTTP_SERVICE_CONFIG_SSL_CCS_SET-Struktur angegeben, die Sie an den pConfigInformation-Parameter übergeben.

Windows 8 und höher: Dieser Enumerationswert wird unterstützt.

[in] pConfigInformation

Zeiger auf einen Puffer, der Daten enthält, die für den im ConfigId-Parameter angegebenen Konfigurationstyp erforderlich sind.

ConfigId-Wert Bedeutung
HttpServiceConfigIPListenList

HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM Struktur.
HttpServiceConfigSSLCertInfo

HTTP_SERVICE_CONFIG_SSL_SET Struktur.
HttpServiceConfigUrlAclInfo

HTTP_SERVICE_CONFIG_URLACL_SET Struktur.
HttpServiceConfigTimeouts

HTTP_SERVICE_CONFIG_TIMEOUT_KEY Struktur.

Windows Vista und höher: Diese Struktur wird unterstützt.
HttpServiceConfigSslSniCertInfo

HTTP_SERVICE_CONFIG_SSL_SNI_SET Struktur. Der Hostname lautet "*", wenn der zentrale SSL-Zertifikatspeicher abgefragt und Wildcardbindungen verwendet werden, und ein Hostname für reguläres SNI.

Windows 8 und höher: Diese Struktur wird unterstützt.
HttpServiceConfigSslCcsCertInfo

HTTP_SERVICE_CONFIG_SSL_CCS_SET Struktur.

Windows 8 und höher: Diese Struktur wird unterstützt.

[in] ConfigInformationLength

Größe des pConfigInformation-Puffers in Bytes.

[in] pOverlapped

Reserviert für zukünftige asynchrone Vorgänge. Dieser Parameter muss auf NULL festgelegt werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion NO_ERROR zurück.

Wenn die Funktion fehlschlägt, gibt sie einen der folgenden Fehlercodes zurück.

Wert Bedeutung
ERROR_INVALID_PARAMETER
 Einer der Parameter ist ungültig.
Andere
 Ein in WinError.h definierter Systemfehlercode .

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile http.h
Bibliothek Httpapi.lib
DLL Httpapi.dll

Weitere Informationen

Funktionen der HTTP-Server-API, Version 1.0

HttpQueryServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration