Condividi tramite


Funzione HttpQueryServiceConfiguration (http.h)

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