Compartilhar via


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

Recupera os sinalizadores para HTTP que determinam se a lista de revogação de certificado é verificada e determinados erros de certificado são ignorados e a política a ser usada quando um servidor redireciona a solicitação HTTP.

Sintaxe

HRESULT GetSecurityFlags(
  [out] ULONG *pFlags
);

Parâmetros

[out] pFlags

Sinalizadores de segurança HTTP que indicam quais erros ignorar ao se conectar ao servidor. Um ou mais dos seguintes sinalizadores podem ser definidos:

Valor Significado
BG_SSL_ENABLE_CRL_CHECK
0x0001
Verifique a CRL (lista de certificados revogados) para verificar se o certificado do servidor não foi revogado.
BG_SSL_IGNORE_CERT_CN_INVALID
0x0002
Ignora erros causados quando o nome do host do certificado do servidor não corresponde ao nome do host na solicitação.
BG_SSL_IGNORE_CERT_DATE_INVALID
0x0004
Ignora erros causados por um certificado expirado.
BG_SSL_IGNORE_UNKNOWN_CA
0x0008
Ignorar erros associados a uma AC (autoridade de certificação) desconhecida.
BG_SSL_IGNORE_CERT_WRONG_USAGE
0x0010
Ignorar erros associados ao uso de um certificado.
BG_HTTP_REDIRECT_POLICY_ALLOW_SILENT
0x0000
Permite que o servidor redirecione sua solicitação para outro servidor. Esse é o padrão.
BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT
0x0100
Permite que o servidor redirecione sua solicitação para outro servidor. O BITS atualiza o nome remoto com a URL final.
BG_HTTP_REDIRECT_POLICY_DISALLOW
0x0200
Places o trabalho no estado de erro fatal quando o servidor redireciona sua solicitação para outro servidor. O BITS atualiza o nome remoto com a URL redirecionada.
BG_HTTP_REDIRECT_POLICY_MASK
0x0700
Bitmask que você pode usar com o valor do sinalizador de segurança para determinar qual política de redirecionamento está em vigor. Ele não inclui o sinalizador ALLOW_HTTPS_TO_HTTP.

O exemplo a seguir mostra como usar essa máscara para testar a política de redirecionamento 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 que o servidor redirecione uma solicitação HTTPS para uma URL HTTP.

Você pode combinar esse sinalizador com BG_HTTP_REDIRECT_POLICY_ALLOW_SILENT e BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT.

Retornar valor

Retorna S_OK quando bem-sucedido.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho bits2_5.h (inclua Bits.h)
Biblioteca Bits.lib

Confira também

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions::SetSecurityFlags