Recupera las marcas de 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 GetSecurityFlags(
[out] ULONG *pFlags
);
Parámetros
[out] pFlags
Marcas de seguridad HTTP que indican qué errores se deben omitir al conectarse al servidor. Se pueden 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 que el servidor redirija la solicitud a otro servidor. Este es el valor predeterminado.
|
-
BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT
- 0x0100
|
Permite que el servidor redirija la solicitud a otro servidor. BITS actualiza el nombre remoto con la dirección URL final.
|
-
BG_HTTP_REDIRECT_POLICY_DISALLOW
- 0x0200
|
Places 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 redirección está en vigor. No incluye la marca ALLOW_HTTPS_TO_HTTP.
En el ejemplo siguiente se muestra cómo usar esta máscara para probar la directiva de redirección de BG_HTTP_REDIRECT_POLICY_DISALLOW.
if (BG_HTTP_REDIRECT_POLICY_DISALLOW == (flags & BG_HTTP_REDIRECT_POLICY_MASK))
|
-
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
Devuelve S_OK cuando se realiza correctamente.
Requisitos
| Requisito |
Value |
|
Cliente mínimo compatible |
Windows Vista |
|
Servidor mínimo compatible |
Windows Server 2008 |
|
Plataforma de destino |
Windows |
|
Encabezado |
bits2_5.h (incluir Bits.h) |
|
Library |
Bits.lib |
Consulte también
IBackgroundCopyJobHttpOptions
IBackgroundCopyJobHttpOptions::SetSecurityFlags