Funzione HttpQueryServiceConfiguration (http.h)

Articolo
01/11/2024

La funzione HttpQueryServiceConfiguration recupera uno o più record di configurazione dell'API del server HTTP.

Sintassi

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
);

Parametri

[in] ServiceHandle

Riservato. Deve essere zero.

[in] ConfigId

Tipo di query del record di configurazione. Questo parametro è uno dei valori seguenti di
HTTP_SERVICE_CONFIG_ID'enumerazione .

Valore ConfigId	Significato
HttpServiceConfigIPListenList	Esegue una query sull'elenco di ascolti IP.
HttpServiceConfigSSLCertInfo	Esegue una query sull'archivio SSL per un record di certificato specifico.
HttpServiceConfigUrlAclInfo	Esegue query sulle informazioni sulla prenotazione URL.
HttpServiceConfigTimeout	Esegue query su timeout di connessione a livello di API server HTTP. Windows Vista e versioni successive: Questa enumerazione è supportata.
HttpServiceConfigSslSniCertInfo	Esegue una query sull'archivio SNI (SSL Server Name Indication) per un record di certificato specifico. Windows 8 e versioni successive: questo valore di enumerazione è supportato.
HttpServiceConfigSslCcsCertInfo	Esegue una query sulla configurazione SSL per un record DELL'archivio certificati centralizzato (CCS) SSL sulla porta. La porta viene specificata dal membro KeyDesc della struttura HTTP_SERVICE_CONFIG_SSL_CCS_QUERY passata al parametro pInputConfigInfo . Windows 8 e versioni successive: questo valore di enumerazione è supportato.

[in, optional] pInput

Puntatore a una struttura il cui contenuto definisce ulteriormente la query e del tipo correlato a ConfigId nella tabella seguente.

Valore ConfigId	Significato
HttpServiceConfigIPListenList	Nessun dato di input; impostare su NULL.
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_QUERY struttura.
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_QUERY struttura.
HttpServiceConfigTimeout	HTTP_SERVICE_CONFIG_TIMEOUT_KEY struttura. Windows Vista e versioni successive: Questa struttura è supportata.
HttpServiceConfigSslSniCertInfo	HTTP_SERVICE_CONFIG_SSL_SNI_QUERY struttura. Windows 8 e versioni successive: questa struttura è supportata.
HttpServiceConfigSslCcsCertInfo	HTTP_SERVICE_CONFIG_SSL_CCS_QUERY struttura. Windows 8 e versioni successive: questa struttura è supportata.

Per altre informazioni, vedere le strutture di query appropriate.

[in, optional] InputLength

Dimensioni, in byte, del buffer pInputConfigInfo .

[in, out, optional] pOutput

Puntatore a un buffer in cui vengono restituiti i risultati della query. Il tipo di questo buffer è correlato a ConfigId.

Valore ConfigId	Significato
HttpServiceConfigIPListenList	HTTP_SERVICE_CONFIG_IP_LISTEN_QUERY struttura.
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET struttura.
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_SET struttura.
HttpServiceConfigTimeout	HTTP_SERVICE_CONFIG_TIMEOUT_PARAM tipo di dati. Windows Vista e versioni successive: Questa struttura è supportata.
HttpServiceConfigSslSniCertInfo	HTTP_SERVICE_CONFIG_SSL_SNI_SET struttura. Windows 8 e versioni successive: questa struttura è supportata.
HttpServiceConfigSslCcsCertInfo	HTTP_SERVICE_CONFIG_SSL_CCS_SET struttura. Windows 8 e versioni successive: questa struttura è supportata.

[in, optional] OutputLength

Dimensioni, in byte, del buffer pOutputConfigInfo .

[out, optional] pReturnLength

Puntatore a una variabile che riceve il numero di byte da scrivere nel buffer di output. Se il buffer di output è troppo piccolo, la chiamata ha esito negativo con un valore restituito di ERROR_INSUFFICIENT_BUFFER. Il valore a cui punta pReturnLength può essere usato per determinare la lunghezza minima richiesta dal buffer affinché la chiamata abbia esito positivo.

[in] pOverlapped

Riservato per l'operazione asincrona e deve essere impostato su NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_INVALID_PARAMETER	Uno dei parametri non è valido.
ERROR_INSUFFICIENT_BUFFER	Il buffer a cui punta pOutputConfigInfo è troppo piccolo per ricevere i dati di output. Chiamare di nuovo la funzione con un buffer pari almeno alla dimensione a cui punta pReturnLength all'uscita.
ERROR_MORE_DATA	Il buffer a cui punta pOutputConfigInfo è troppo piccolo per ricevere i dati di output. Chiamare di nuovo la funzione con un buffer pari almeno alla dimensione a cui punta pReturnLength all'uscita.
ERROR_NO_MORE_ITEMS	Non sono presenti altri elementi da restituire che soddisfano i criteri specificati.
Altri	Codice di errore di sistema definito in WinError.h.

Requisiti


Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	http.h
Libreria	Httpapi.lib
DLL	Httpapi.dll

Vedi anche

Funzioni API SERVER HTTP versione 1.0

HttpDeleteServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration

Share via