Enumeración WinHttpRequestOption

Artículo
06/03/2023

La enumeración WinHttpRequestOption incluye opciones que se pueden establecer o recuperar para la sesión actual de Servicios HTTP de Microsoft Windows (WinHTTP).

Sintaxis

typedef enum WinHttpRequestOption { 
  WinHttpRequestOption_UserAgentString,
  WinHttpRequestOption_URL,
  WinHttpRequestOption_URLCodePage,
  WinHttpRequestOption_EscapePercentInURL,
  WinHttpRequestOption_SslErrorIgnoreFlags,
  WinHttpRequestOption_SelectCertificate,
  WinHttpRequestOption_EnableRedirects,
  WinHttpRequestOption_UrlEscapeDisable,
  WinHttpRequestOption_UrlEscapeDisableQuery,
  WinHttpRequestOption_SecureProtocols,
  WinHttpRequestOption_EnableTracing,
  WinHttpRequestOption_RevertImpersonationOverSsl,
  WinHttpRequestOption_EnableHttpsToHttpRedirects,
  WinHttpRequestOption_EnablePassportAuthentication,
  WinHttpRequestOption_MaxAutomaticRedirects,
  WinHttpRequestOption_MaxResponseHeaderSize,
  WinHttpRequestOption_MaxResponseDrainSize,
  WinHttpRequestOption_EnableHttp1_1,
  WinHttpRequestOption_EnableCertificateRevocationCheck
} WinHttpRequestOption;

Constantes

WinHttpRequestOption_UserAgentString

Establece o recupera un valor VARIANT que contiene la cadena del agente de usuario .

WinHttpRequestOption_URL

Recupera un valor VARIANT que contiene la dirección URL del recurso. Este valor es de solo lectura; No se puede establecer la dirección URL mediante esta propiedad. La dirección URL no se puede leer hasta que se llame al método Open . Esta opción es útil para comprobar la dirección URL una vez finalizado el método Send para comprobar que se ha producido cualquier redireccionamiento.

WinHttpRequestOption_URLCodePage

Establece o recupera un valor VARIANT que identifica la página de códigos de la cadena de dirección URL. El valor predeterminado es la página de códigos UTF-8. La página de códigos se usa para convertir la cadena de dirección URL Unicode, pasada en el método Open , a una representación de cadena de un solo byte.

WinHttpRequestOption_EscapePercentInURL

Establece o recupera un valor VARIANT que indica si los caracteres de porcentaje de la cadena de dirección URL se convierten en una secuencia de escape. El valor predeterminado de esta opción es VARIANT_TRUE que especifica todos los caracteres no seguros del American National Standards Institute (ANSI), excepto el símbolo de porcentaje, se convierten en una secuencia de escape.

WinHttpRequestOption_SslErrorIgnoreFlags

Establece o recupera un valor VARIANT que indica qué errores de certificado de servidor se deben omitir. Puede ser una combinación de una o varias de las marcas siguientes.

Error	Valor
Entidad de certificación (CA) desconocida o raíz que no es de confianza	0x0100
Uso incorrecto	0x0200
Nombre común (CN) no válido	0x1000
Fecha o certificado no válido expirados	0x2000

El valor predeterminado de esta opción en la versión 5.1 de WinHTTP es cero, lo que no produce errores que se omiten. En versiones anteriores de WinHTTP, la configuración predeterminada era 0x3300, lo que dio lugar a que todos los errores de certificado de servidor se omiten de forma predeterminada.

WinHttpRequestOption_SelectCertificate

Establece un valor VARIANT que especifica el certificado de cliente que se envía a un servidor para la autenticación. Esta opción indica la ubicación, el almacén de certificados y el asunto de un certificado de cliente delimitado con barras diagonales inversas. Para obtener más información sobre cómo seleccionar un certificado de cliente, consulte SSL en WinHTTP.

WinHttpRequestOption_EnableRedirects

Establece o recupera un valor VARIANT que indica si las solicitudes se redirigen automáticamente cuando el servidor especifica una nueva ubicación para el recurso. El valor predeterminado de esta opción es VARIANT_TRUE para indicar que las solicitudes se redirigen automáticamente.

WinHttpRequestOption_UrlEscapeDisable

Establece o recupera un valor VARIANT que indica si los caracteres no seguros de la ruta de acceso y los componentes de consulta de una dirección URL se convierten en secuencias de escape. El valor predeterminado de esta opción es VARIANT_TRUE, que especifica que se convierten los caracteres de la ruta de acceso y la consulta.

WinHttpRequestOption_UrlEscapeDisableQuery

Establece o recupera un valor VARIANT que indica si los caracteres no seguros del componente de consulta de la dirección URL se convierten en secuencias de escape. El valor predeterminado de esta opción es VARIANT_TRUE, que especifica que se convierten los caracteres de la consulta.

WinHttpRequestOption_SecureProtocols

Establece o recupera un valor VARIANT que indica qué protocolos seguros se pueden usar. Esta opción selecciona los protocolos aceptables para el cliente. El protocolo se negocia durante el protocolo de enlace Capa de sockets seguros (SSL). Puede ser una combinación de una o varias de las marcas siguientes.

Protocolo	Value
SSL 2.0	0x0008
SSL 3.0	0x0020
Seguridad de la capa de transporte (TLS) 1.0	0x0080

El valor predeterminado de esta opción es 0x0028, que indica que se puede usar SSL 2.0 o SSL 3.0. Si esta opción se establece en cero, el cliente y el servidor no pueden determinar un protocolo de seguridad aceptable y el siguiente envío produce un error.

WinHttpRequestOption_EnableTracing

Establece o recupera un valor VARIANT que indica si el seguimiento está habilitado actualmente. Consulta también Recopilar seguimientos de WinHTTP.

WinHttpRequestOption_RevertImpersonationOverSsl

Controla si el objeto WinHttpRequest revierte temporalmente la suplantación de cliente mientras duren las operaciones de autenticación de certificados SSL. La configuración predeterminada del objeto WinHttpRequest es TRUE. Establezca esta opción en FALSE para mantener la suplantación mientras realiza operaciones de autenticación de certificados.

WinHttpRequestOption_EnableHttpsToHttpRedirects

Controla si WinHTTP permite o no redireccionamientos. De forma predeterminada, se siguen automáticamente todas las redirecciones, excepto las que se transfieren de una dirección URL segura (https) a una dirección URL no segura (http). Establezca esta opción en TRUE para habilitar HTTPS en redirecciones HTTP.

WinHttpRequestOption_EnablePassportAuthentication

Habilita o deshabilita la compatibilidad con la autenticación de Passport. De forma predeterminada, la compatibilidad automática con la autenticación de Passport está deshabilitada; establezca esta opción en TRUE para habilitar la compatibilidad con la autenticación de Passport.

WinHttpRequestOption_MaxAutomaticRedirects

Establece o recupera el número máximo de redirecciones que WinHTTP sigue; el valor predeterminado es 10. Este límite impide que los sitios no autorizados hagan que el cliente WinHTTP se detenga después de un gran número de redireccionamientos.