Share via

Método IBackgroundCopyJobHttpOptions::SetSecurityFlags (bits2_5.h)

  • Artículo

Establece marcas para HTTP que determinan si se comprueba la lista de revocación de certificados y se omiten determinados errores de certificado y la directiva que se va a usar cuando un servidor redirige la solicitud HTTP.

Sintaxis

HRESULT SetSecurityFlags(
  [in] ULONG Flags
);

Parámetros

[in] Flags

Marcas de seguridad HTTP que indican qué errores omitir al conectarse al servidor. Puede establecer una o varias de las marcas siguientes:

Valor Significado
BG_SSL_ENABLE_CRL_CHECK
0x0001
 Compruebe la lista de revocación de certificados (CRL) para comprobar que el certificado de servidor no se ha revocado.
BG_SSL_IGNORE_CERT_CN_INVALID
0x0002
 Omite los errores causados cuando el nombre de host del certificado del servidor no coincide con el nombre de host de la solicitud.
BG_SSL_IGNORE_CERT_DATE_INVALID
0x0004
 Omite los errores causados por un certificado expirado.
BG_SSL_IGNORE_UNKNOWN_CA
0x0008
 Omita los errores asociados a una entidad de certificación (CA) desconocida.
BG_SSL_IGNORE_CERT_WRONG_USAGE
0x0010
 Omita los errores asociados al uso de un certificado.
BG_HTTP_REDIRECT_POLICY_ALLOW_SILENT
0x0000
 Permite al servidor redirigir la solicitud a otro servidor. Este es el valor predeterminado.
BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT
0x0100
 Permite al servidor redirigir la solicitud a otro servidor. BITS actualiza el nombre remoto con la dirección URL final.
BG_HTTP_REDIRECT_POLICY_DISALLOW
0x0200
 Coloca el trabajo en el estado de error irrecuperable cuando el servidor redirige la solicitud a otro servidor. BITS actualiza el nombre remoto con la dirección URL redirigida.
BG_HTTP_REDIRECT_POLICY_MASK
0x0700
 Máscara de bits que puede usar con el valor de la marca de seguridad para determinar qué directiva de redireccionamiento está en vigor. No incluye la marca ALLOW_HTTPS_TO_HTTP.
BG_HTTP_REDIRECT_POLICY_ALLOW_HTTPS_TO_HTTP
0x0800
 Permite al servidor redirigir una solicitud HTTPS a una dirección URL HTTP.

Puede combinar esta marca con BG_HTTP_REDIRECT_POLICY_ALLOW_SILENT y BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT.

Valor devuelto

En la tabla siguiente se enumeran algunos de los posibles valores devueltos.

Código devuelto Descripción
S_OK
 Recuperó correctamente los encabezados.
E_NOTIMPL
 No se admite el valor de marca.

Comentarios

Si se solicita la comprobación de CRL, BITS realiza la comprobación de todos los archivos del trabajo que especifican el protocolo HTTPS. La comprobación se realiza para cada archivo antes de que el archivo comience a transferirse. Si establece este valor en TRUE después de que BITS haya descargado parcialmente un archivo, BITS volverá a programar el trabajo y comenzará a descargar el archivo de nuevo. Los archivos que ya están descargados no se ven afectados.

BITS usa la CRL en el equipo local si la CRL está actualizada; de lo contrario, BITS descarga la CRL de la entidad de certificación (CA) que firmó el certificado.

El trabajo entra en el estado de error irrecuperable si se producen los siguientes errores.

Código de error Descripción
ERROR_WINHTTP_SECURE_CERT_REV_FAILED No se puede solicitar la comprobación de CRL porque el servidor de certificados está sin conexión o no se puede descargar la CRL.
ERROR_WINHTTP_SECURE_CERT_REVOKED Se revoca el certificado.
 

La directiva de redireccionamiento se aplica a todos los archivos de un trabajo de descarga (la directiva no se aplica a los trabajos de carga).

Antes de BITS 3.0: No se admiten las directivas de redireccionamiento.

Si la directiva es BG_HTTP_REDIRECT_POLICY_DISALLOW y el servidor redirige la solicitud, el trabajo se coloca en el estado de error irrecuperable con uno de los siguientes códigos de error. Para obtener descripciones de los códigos de error, consulte Códigos de estado HTTP.

  • HRESULT_FROM_WIN32(HTTP_STATUS_AMBIGUOUS)
  • HRESULT_FROM_WIN32(HTTP_STATUS_MOVED)
  • HRESULT_FROM_WIN32(HTTP_STATUS_REDIRECT)
  • HRESULT_FROM_WIN32(HTTP_STATUS_REDIRECT_METHOD)
  • HRESULT_FROM_WIN32(HTTP_STATUS_REDIRECT_KEEP_VERB)
BITS no admite el redireccionamiento desde HTTP o HTTP a SMB.

Si el almacenamiento en caché del mismo nivel está habilitado y especifica BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT, el archivo se almacena en la memoria caché con la dirección URL redirigida final. Si un elemento del mismo nivel intenta descargar el archivo con la dirección URL original, el elemento del mismo nivel no encontrará el archivo en la memoria caché del mismo nivel y terminará descargando el archivo desde el servidor de origen.

Si especifica y el archivo se descarga desde el

Tenga en cuenta que establecer BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT puede afectar al resultado al llamar al método IBackgroundCopyJob3::ReplaceRemotePrefix . Si un servidor redirigió la solicitud, BITS ya habrá cambiado la dirección URL original a la dirección URL redirigida final, por lo que llamar al método ReplaceRemotePrefix no encontrará archivos con la dirección URL original.

Requisitos

   
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado bits2_5.h (incluya Bits.h)
Library Bits.lib

Consulte también

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions::GetSecurityFlags