Metodo IBackgroundCopyJobHttpOptions::GetSecurityFlags (bits2_5.h)

Articolo
03/14/2023

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.

Valore restituito

Restituisce S_OK al termine dell'operazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	bits2_5.h (includere Bits.h)
Libreria	Bits.lib

Vedi anche

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions::SetSecurityFlags

Condividi tramite