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