HttpQueryServiceConfiguration-Funktion (http.h)

  • Artikel

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