HttpDeleteServiceConfiguration-Funktion (http.h)
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 |
|---|---|
|
Löscht eine angegebene IP-Adresse aus der IP-Listenliste. |
|
Löscht einen angegebenen SSL-Zertifikatdatensatz. |
|
Löscht einen angegebenen URL-Reservierungsdatensatz. |
|
Löscht ein angegebenes Verbindungstimeout.
Windows Vista und höher: Diese Enumeration wird unterstützt. |
|
Löscht einen angegebenen SSL Server Name Indication (SNI)-Zertifikatdatensatz.
Windows 8 und höher: Dieser Enumerationswert wird unterstützt. |
|
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 |
|---|---|
|
HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM Struktur. |
|
HTTP_SERVICE_CONFIG_SSL_SET Struktur. |
|
HTTP_SERVICE_CONFIG_URLACL_SET Struktur. |
|
HTTP_SERVICE_CONFIG_TIMEOUT_KEY Struktur. Windows Vista und höher: Diese Struktur wird unterstützt. |
|
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. |
|
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 |
|---|---|
|
Einer der Parameter ist ungültig. |
|
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 |