HttpSetServiceConfiguration-Funktion (http.h)

Artikel
08/24/2023

Die HttpSetServiceConfiguration-Funktion erstellt und legt einen Konfigurationsdatensatz für den HTTP-Server-API-Konfigurationsspeicher fest. Der Aufruf schlägt fehl, wenn der angegebene Datensatz bereits vorhanden ist. Um einen bestimmten Konfigurationsdatensatz zu ändern, löschen Sie ihn, und erstellen Sie ihn dann mit einem anderen Wert neu.

Syntax

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

Parameter

[in] ServiceHandle

Reserviert. Muss Null sein.

[in] ConfigId

Typ des festzulegenden Konfigurationsdatensatzes. Dieser Parameter kann einer der folgenden Werte aus der HTTP_SERVICE_CONFIG_ID-Enumeration sein.

ConfigId-Wert	Bedeutung
HttpServiceConfigIPListenList	Legt einen Eintrag in der IP-Listenliste fest.
HttpServiceConfigSSLCertInfo	Legt einen angegebenen SSL-Zertifikatdatensatz fest.
HttpServiceConfigUrlAclInfo	Legt einen URL-Reservierungsdatensatz fest.
HttpServiceConfigTimeout	Legt ein angegebenes HTTP-Server-API-Verbindungstimeout fest. Windows Vista und höher: Dieser Enumerationswert wird unterstützt.
HttpServiceConfigSslSniCertInfo	Legt einen angegebenen SSL Server Name Indication (SNI)-Zertifikatdatensatz fest. Windows 8 und höher: Dieser Enumerationswert wird unterstützt.
HttpServiceConfigSslCcsCertInfo	Legt den SSL-Zertifikateintrag fest, der angibt, dass Http.sys im CCS-Speicher (Centralized Certificate Store) nach Zertifikaten suchen sollen, 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

Ein Zeiger auf einen Puffer, der die entsprechenden Daten enthält, um den Typ des festzulegenden Datensatzes anzugeben.

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.
HttpServiceConfigTimeout	HTTP_SERVICE_CONFIG_TIMEOUT_SET 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

Dieser Parameter ist reserviert und muss NULL sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert	Bedeutung
ERROR_ALREADY_EXISTS	Der angegebene Datensatz ist bereits vorhanden und muss gelöscht werden, damit sein Wert erneut festgelegt wird.
ERROR_INSUFFICIENT_BUFFER	Die im Parameter ConfigInformationLength angegebene Puffergröße reicht nicht aus.
ERROR_INVALID_HANDLE	Der ServiceHandle-Parameter ist ungültig.
ERROR_INVALID_PARAMETER	Mindestens einer der angegebenen Parameter ist in einer nicht verwendbaren Form vorhanden.
ERROR_NO_SUCH_LOGON_SESSION	Das verwendete SSL-Zertifikat ist ungültig. Dies kann nur auftreten, wenn der Parameter HttpServiceConfigSSLCertInfo verwendet wird.
Andere	Ein in WinError.h definierter Systemfehlercode .

Hinweise

Die mit HttpSetServiceConfiguration festgelegten Konfigurationsparameter werden auf alle HTTP-Server-API-Anwendungen auf dem Computer angewendet und beibehalten, wenn die HTTP-Server-API heruntergefahren wird oder der Computer neu gestartet wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	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

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpUpdateServiceConfiguration

Freigeben über