HttpSetServiceConfiguration-Funktion (http.h)

  • Artikel

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