HttpQueryServiceConfiguration-Funktion (http.h)

Artikel
01/10/2024

Die HttpQueryServiceConfiguration-Funktion ruft einen oder mehrere HTTP-Server-API-Konfigurationsdatensätze ab.

Syntax

HTTPAPI_LINKAGE ULONG HttpQueryServiceConfiguration(
  [in]                HANDLE                 ServiceHandle,
  [in]                HTTP_SERVICE_CONFIG_ID ConfigId,
  [in, optional]      PVOID                  pInput,
  [in, optional]      ULONG                  InputLength,
  [in, out, optional] PVOID                  pOutput,
  [in, optional]      ULONG                  OutputLength,
  [out, optional]     PULONG                 pReturnLength,
  [in]                LPOVERLAPPED           pOverlapped
);

Parameter

[in] ServiceHandle

Reserviert. Muss Null sein.

[in] ConfigId

Der Abfragetyp des Konfigurationsdatensatzes. Dieser Parameter ist einer der folgenden Werte aus der
HTTP_SERVICE_CONFIG_ID-Enumeration .

ConfigId-Wert	Bedeutung
HttpServiceConfigIPListenList	Fragt die IP-Listenliste ab.
HttpServiceConfigSSLCertInfo	Fragt den SSL-Speicher nach einem bestimmten Zertifikatdatensatz ab.
HttpServiceConfigUrlAclInfo	Fragt URL-Reservierungsinformationen ab.
HttpServiceConfigTimeout	Fragt http-Server-API-weite Verbindungstimeouts ab. Windows Vista und höher: Diese Enumeration wird unterstützt.
HttpServiceConfigSslSniCertInfo	Fragt den SNI-Speicher (SSL Server Name Indication) nach einem bestimmten Zertifikatdatensatz ab. Windows 8 und höher: Dieser Enumerationswert wird unterstützt.
HttpServiceConfigSslCcsCertInfo	Fragt die SSL-Konfiguration für einen CCS-Eintrag (SSL Centralized Certificate Store) am Port ab. Der Port wird vom KeyDesc-Element der HTTP_SERVICE_CONFIG_SSL_CCS_QUERY-Struktur angegeben, die Sie an den pInputConfigInfo-Parameter übergeben. Windows 8 und höher: Dieser Enumerationswert wird unterstützt.

[in, optional] pInput

Ein Zeiger auf eine Struktur, deren Inhalt die Abfrage und den Typ weiter definiert, der mit ConfigId in der folgenden Tabelle korreliert.

ConfigId-Wert	Bedeutung
HttpServiceConfigIPListenList	Keine Eingabedaten; auf NULL festgelegt.
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_QUERY Struktur.
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_QUERY Struktur.
HttpServiceConfigTimeout	HTTP_SERVICE_CONFIG_TIMEOUT_KEY Struktur. Windows Vista und höher: Diese Struktur wird unterstützt.
HttpServiceConfigSslSniCertInfo	HTTP_SERVICE_CONFIG_SSL_SNI_QUERY Struktur. Windows 8 und höher: Diese Struktur wird unterstützt.
HttpServiceConfigSslCcsCertInfo	HTTP_SERVICE_CONFIG_SSL_CCS_QUERY Struktur. Windows 8 und höher: Diese Struktur wird unterstützt.

Weitere Informationen finden Sie in den entsprechenden Abfragestrukturen.

[in, optional] InputLength

Größe des pInputConfigInfo-Puffers in Byte.

[in, out, optional] pOutput

Ein Zeiger auf einen Puffer, in dem die Abfrageergebnisse zurückgegeben werden. Der Typ dieses Puffers korreliert mit ConfigId.

ConfigId-Wert	Bedeutung
HttpServiceConfigIPListenList	HTTP_SERVICE_CONFIG_IP_LISTEN_QUERY Struktur.
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET Struktur.
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_SET Struktur.
HttpServiceConfigTimeout	HTTP_SERVICE_CONFIG_TIMEOUT_PARAM Datentyp. Windows Vista und höher: Diese Struktur wird unterstützt.
HttpServiceConfigSslSniCertInfo	HTTP_SERVICE_CONFIG_SSL_SNI_SET Struktur. 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, optional] OutputLength

Größe des pOutputConfigInfo-Puffers in Bytes.

[out, optional] pReturnLength

Ein Zeiger auf eine Variable, die die Anzahl der Bytes empfängt, die in den Ausgabepuffer geschrieben werden sollen. Wenn der Ausgabepuffer zu klein ist, schlägt der Aufruf mit dem Rückgabewert ERROR_INSUFFICIENT_BUFFER fehl. Der Wert, auf den pReturnLength verweist, kann verwendet werden, um die Mindestlänge zu bestimmen, die der Puffer für den erfolgreichen Aufruf benötigt.

[in] pOverlapped

Reserviert für asynchrone Vorgänge und muss auf NULL festgelegt werden.

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_INVALID_PARAMETER	Einer der Parameter ist ungültig.
ERROR_INSUFFICIENT_BUFFER	Der Puffer, auf den pOutputConfigInfo verweist, ist zu klein, um die Ausgabedaten zu empfangen. Rufen Sie die Funktion erneut mit einem Puffer auf, der mindestens so groß ist wie die Größe, auf die pReturnLength beim Beenden verweist.
ERROR_MORE_DATA	Der Puffer, auf den pOutputConfigInfo verweist, ist zu klein, um die Ausgabedaten zu empfangen. Rufen Sie die Funktion erneut mit einem Puffer auf, der mindestens so groß ist wie die Größe, auf die pReturnLength beim Beenden verweist.
ERROR_NO_MORE_ITEMS	Es gibt keine weiteren Elemente zurückzugeben, die die angegebenen Kriterien erfüllen.
Andere	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

Weitere Informationen

Funktionen der HTTP-Server-API, Version 1.0

HttpDeleteServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration

Freigeben über