Metodo IBackgroundCopyJobHttpOptions::GetSecurityFlags (bits2_5.h)
Articolo
Recupera i flag per HTTP che determinano se l'elenco di revoche di certificati viene controllato e alcuni errori di certificato vengono ignorati e i criteri da usare quando un server reindirizza la richiesta HTTP.
Sintassi
HRESULT GetSecurityFlags(
[out] ULONG *pFlags
);
Parametri
[out] pFlags
Flag di sicurezza HTTP che indicano quali errori ignorare durante la connessione al server. È possibile impostare uno o più flag seguenti:
Valore
Significato
BG_SSL_ENABLE_CRL_CHECK
0x0001
Controllare l'elenco di revoche di certificati (CRL) per verificare che il certificato del server non sia stato revocato.
BG_SSL_IGNORE_CERT_CN_INVALID
0x0002
Ignora gli errori causati quando il nome host del certificato del server non corrisponde al nome host nella richiesta.
BG_SSL_IGNORE_CERT_DATE_INVALID
0x0004
Ignora gli errori causati da un certificato scaduto.
BG_SSL_IGNORE_UNKNOWN_CA
0x0008
Ignorare gli errori associati a un'autorità di certificazione sconosciuta (CA).
BG_SSL_IGNORE_CERT_WRONG_USAGE
0x0010
Ignorare gli errori associati all'uso di un certificato.
BG_HTTP_REDIRECT_POLICY_ALLOW_SILENT
0x0000
Consente al server di reindirizzare la richiesta a un altro server. Questo è il valore predefinito.
BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT
0x0100
Consente al server di reindirizzare la richiesta a un altro server. BITS aggiorna il nome remoto con l'URL finale.
BG_HTTP_REDIRECT_POLICY_DISALLOW
0x0200
Places il processo nello stato di errore irreversibile quando il server reindirizza la richiesta a un altro server. BITS aggiorna il nome remoto con l'URL reindirizzato.
BG_HTTP_REDIRECT_POLICY_MASK
0x0700
Maschera di bit che è possibile usare con il valore del flag di sicurezza per determinare quale criterio di reindirizzamento è effettivo. Non include il flag ALLOW_HTTPS_TO_HTTP.
Nell'esempio seguente viene illustrato come usare questa maschera per testare i criteri di reindirizzamento 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
Consente al server di reindirizzare una richiesta HTTPS a un URL HTTP.
È possibile combinare questo flag con BG_HTTP_REDIRECT_POLICY_ALLOW_SILENT e BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT.