Función HttpQueryServiceConfiguration (http.h)

Artículo
01/11/2024

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

Compartir a través de