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

Artículo
02/26/2024

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

Share via