Freigeben über

HttpSetServiceConfiguration-Funktion (http.h)

Die HttpSetServiceConfiguration-Funktion erstellt und legt einen Konfigurationsdatensatz für den KONFIGURATIONSspeicher der HTTP-Server-API fest. Der Aufruf schlägt fehl, wenn der angegebene Datensatz bereits vorhanden ist. Wenn Sie einen bestimmten Konfigurationsdatensatz ändern möchten, 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
);

Die 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 Datensatz in der IP-Listenliste fest.
HttpServiceConfigssLCertInfo
 Legt einen angegebenen SSL-Zertifikatdatensatz fest.
HttpServiceConfigUrlAclInfo
 Legt einen URL-Reservierungsdatensatz fest.
HttpServiceConfigTimeout
 Legt einen angegebenen HTTP-Server-API-weiten Verbindungstimeout fest.

Windows Vista und höher: Dieser Enumerationswert wird unterstützt.
HttpServiceConfigSslSniCertInfo
 Legt einen angegebenen SNI-Zertifikateintrag (SSL Server Name Indication) fest.

Windows 8 und höher: Dieser Enumerationswert wird unterstützt.
HttpServiceConfigSslCcsCertInfo
 Legt den SSL-Zertifikatdatensatz fest, 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

Ein Zeiger auf einen Puffer, der die entsprechenden Daten enthält, um den festzulegenden Datensatztyp 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 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

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 werden kann.
ERROR_INSUFFICIENT_BUFFER
 Die im Parameter ConfigInformationLength angegebene Puffergröße ist nicht ausreichend.
ERROR_INVALID_HANDLE
 Der Parameter ServiceHandle ist ungültig.
ERROR_INVALID_PARAMETER
 Mindestens einer der angegebenen Parameter ist in unbrauchbarer 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 .

Bemerkungen

Die konfigurationsparameter, die mit HttpSetServiceConfiguration festgelegt sind, werden auf alle HTTP Server-API-Anwendungen auf dem Computer angewendet und bleiben erhalten, wenn die HTTP-Server-API heruntergefahren wird oder wenn der Computer neu gestartet wird.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client 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

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpUpdateServiceConfiguration

  • Last updated on