HttpSetServiceConfiguration-Funktion (http.h)
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 |
|---|---|
|
Legt einen Eintrag in der IP-Listenliste fest. |
|
Legt einen angegebenen SSL-Zertifikatdatensatz fest. |
|
Legt einen URL-Reservierungsdatensatz fest. |
|
Legt ein angegebenes HTTP-Server-API-Verbindungstimeout fest. Windows Vista und höher: Dieser Enumerationswert wird unterstützt. |
|
Legt einen angegebenen SSL Server Name Indication (SNI)-Zertifikatdatensatz fest.
Windows 8 und höher: Dieser Enumerationswert wird unterstützt. |
|
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 |
|---|---|
|
HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM Struktur. |
|
HTTP_SERVICE_CONFIG_SSL_SET Struktur. |
|
HTTP_SERVICE_CONFIG_URLACL_SET Struktur. |
|
HTTP_SERVICE_CONFIG_TIMEOUT_SET 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
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 |
|---|---|
|
Der angegebene Datensatz ist bereits vorhanden und muss gelöscht werden, damit sein Wert erneut festgelegt wird. |
|
Die im Parameter ConfigInformationLength angegebene Puffergröße reicht nicht aus. |
|
Der ServiceHandle-Parameter ist ungültig. |
|
Mindestens einer der angegebenen Parameter ist in einer nicht verwendbaren Form vorhanden. |
|
Das verwendete SSL-Zertifikat ist ungültig. Dies kann nur auftreten, wenn der Parameter HttpServiceConfigSSLCertInfo verwendet wird. |
|
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