Función HttpQueryServiceConfiguration (http.h)

  • Artículo

La función HttpQueryServiceConfiguration recupera uno o varios registros de configuración de la API de SERVIDOR HTTP.

Sintaxis

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

Parámetros

[in] ServiceHandle

Reservado. Debe ser cero.

[in] ConfigId

Tipo de consulta de registro de configuración. Este parámetro es uno de los siguientes valores de .
HTTP_SERVICE_CONFIG_ID enumeración.

Valor configId Significado
HttpServiceConfigIPListenList
 Consulta la lista de escucha ip.
HttpServiceConfigSSLCertInfo
 Consulta el almacén SSL para un registro de certificado específico.
HttpServiceConfigUrlAclInfo
 Consulta la información de reserva de direcciones URL.
HttpServiceConfigTimeout
 Consulta tiempos de espera de conexión anchos de LA API del servidor HTTP.

Windows Vista y versiones posteriores: Esta enumeración se admite.
HttpServiceConfigSslSniCertInfo
 Consulta el almacén de indicación de nombre de servidor SSL (SNI) para un registro de certificado específico.

Windows 8 y versiones posteriores: se admite este valor de enumeración.
HttpServiceConfigSslCcsCertInfo
 Consulta la configuración de SSL para un registro del almacén de certificados centralizado (CCS) ssl en el puerto. El puerto lo especifica el miembro KeyDesc de la estructura HTTP_SERVICE_CONFIG_SSL_CCS_QUERY que se pasa al parámetro pInputConfigInfo .

Windows 8 y versiones posteriores: se admite este valor de enumeración.

[in, optional] pInput

Puntero a una estructura cuyo contenido define aún más la consulta y del tipo que se correlaciona con ConfigId en la tabla siguiente.

Valor configId Significado
HttpServiceConfigIPListenList
 Sin datos de entrada; se establece en NULL.
HttpServiceConfigSSLCertInfo

HTTP_SERVICE_CONFIG_SSL_QUERY estructura.
HttpServiceConfigUrlAclInfo

HTTP_SERVICE_CONFIG_URLACL_QUERY estructura.
HttpServiceConfigTimeout

HTTP_SERVICE_CONFIG_TIMEOUT_KEY estructura.

Windows Vista y versiones posteriores: Se admite esta estructura.
HttpServiceConfigSslSniCertInfo

HTTP_SERVICE_CONFIG_SSL_SNI_QUERY estructura.

Windows 8 y versiones posteriores: se admite esta estructura.
HttpServiceConfigSslCcsCertInfo

HTTP_SERVICE_CONFIG_SSL_CCS_QUERY estructura.

Windows 8 y versiones posteriores: se admite esta estructura.
 

Para obtener más información, consulte las estructuras de consulta adecuadas.

[in, optional] InputLength

Tamaño, en bytes, del búfer pInputConfigInfo .

[in, out, optional] pOutput

Puntero a un búfer en el que se devuelven los resultados de la consulta. El tipo de este búfer se correlaciona con ConfigId.

Valor configId Significado
HttpServiceConfigIPListenList

HTTP_SERVICE_CONFIG_IP_LISTEN_QUERY estructura.
HttpServiceConfigSSLCertInfo

HTTP_SERVICE_CONFIG_SSL_SET estructura.
HttpServiceConfigUrlAclInfo

HTTP_SERVICE_CONFIG_URLACL_SET estructura.
HttpServiceConfigTimeout

HTTP_SERVICE_CONFIG_TIMEOUT_PARAM tipo de datos.

Windows Vista y versiones posteriores: Se admite esta estructura.
HttpServiceConfigSslSniCertInfo

HTTP_SERVICE_CONFIG_SSL_SNI_SET estructura.

Windows 8 y versiones posteriores: se admite esta estructura.
HttpServiceConfigSslCcsCertInfo

HTTP_SERVICE_CONFIG_SSL_CCS_SET estructura.

Windows 8 y versiones posteriores: se admite esta estructura.

[in, optional] OutputLength

Tamaño, en bytes, del búfer pOutputConfigInfo .

[out, optional] pReturnLength

Puntero a una variable que recibe el número de bytes que se van a escribir en el búfer de salida. Si el búfer de salida es demasiado pequeño, se produce un error en la llamada con un valor devuelto de ERROR_INSUFFICIENT_BUFFER. El valor al que apunta pReturnLength se puede usar para determinar la longitud mínima que requiere el búfer para que la llamada se realice correctamente.

[in] pOverlapped

Reservado para la operación asincrónica y debe establecerse en NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Valor Significado
ERROR_INVALID_PARAMETER
 Uno de los parámetros no es válido.
ERROR_INSUFFICIENT_BUFFER
 El búfer al que apunta pOutputConfigInfo es demasiado pequeño para recibir los datos de salida. Vuelva a llamar a la función con un búfer al menos tan grande como el tamaño al que apunta pReturnLength al salir.
ERROR_MORE_DATA
 El búfer al que apunta pOutputConfigInfo es demasiado pequeño para recibir los datos de salida. Vuelva a llamar a la función con un búfer al menos tan grande como el tamaño al que apunta pReturnLength al salir.
ERROR_NO_MORE_ITEMS
 No hay más elementos que devolver que cumplan los criterios especificados.
Otros
 Código de error del sistema definido en WinError.h.

Requisitos

   
Cliente mínimo compatible Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado http.h
Library Httpapi.lib
Archivo DLL Httpapi.dll

Consulte también

Funciones de la API de servidor HTTP versión 1.0

HttpDeleteServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration