Freigeben über

HttpDeleteServiceConfiguration-Funktion (http.h)

Die HttpDeleteServiceConfiguration-Funktion löscht angegebene Daten, z. B. IP-Adressen oder SSL-Zertifikate, aus dem KONFIGURATIONSspeicher der HTTP-Server-API, 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
);

Die Parameter

[in] ServiceHandle

Dieser Parameter ist reserviert und muss null sein.

[in] ConfigId

Konfigurationstyp. 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-Zertifikateintrag.
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 SNI-Zertifikateintrag (SSL Server Name Indication).

Windows 8 und höher: Dieser Enumerationswert wird unterstützt.
HttpServiceConfigSslCcsCertInfo
 Löscht den SSL-Zertifikateintrag, der angibt, dass Http.sys den zentralen Zertifikatspeicher (CENTRALized Certificate Store, CCS) konsultieren soll, um Zertifikate zu finden, wenn der Port einen TLS-Handshake (Transport Layer Security) empfängt. Der Port wird durch das KeyDesc-Element 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

Zeigen Sie auf einen Puffer, der Daten enthält, die für den konfigurationstyp erforderlich sind, der im ConfigId-Parameter angegeben ist.

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 wird und Wildcardbindungen verwendet werden, und ein Hostname für reguläre 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, wird eine der folgenden Fehlercodes zurückgegeben.

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

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2003 [Nur Desktop-Apps]
Zielplattform Fenster
Header http.h
Library Httpapi.lib
DLL Httpapi.dll

Siehe auch

HTTP Server API Version 1.0-Funktionen

HttpQueryServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration

  • Last updated on