Método IBackgroundCopyJobHttpOptions::SetSecurityFlags (bits2_5.h)
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 devuelto
En la tabla siguiente se enumeran algunos de los posibles valores devueltos.
| Código devuelto | Descripción |
|---|---|
|
Recuperó correctamente los encabezados. |
|
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)
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 |