Извлекает флаги для HTTP, которые определяют, проверяется ли список отзыва сертификатов и игнорируются ли определенные ошибки сертификата, а также политика, используемая при перенаправлении HTTP-запроса сервером.
Синтаксис
HRESULT GetSecurityFlags(
[out] ULONG *pFlags
);
Параметры
[out] pFlags
Флаги безопасности HTTP, указывающие, какие ошибки следует игнорировать при подключении к серверу. Можно задать один или несколько из следующих флагов:
| Значение |
Значение |
-
BG_SSL_ENABLE_CRL_CHECK
- 0x0001
|
Проверьте список отзыва сертификатов (CRL), чтобы убедиться, что сертификат сервера не был отозван.
|
-
BG_SSL_IGNORE_CERT_CN_INVALID
- 0x0002
|
Игнорирует ошибки, вызванные тем, что имя узла сертификата сервера не соответствует имени узла в запросе.
|
-
BG_SSL_IGNORE_CERT_DATE_INVALID
- 0x0004
|
Игнорирует ошибки, вызванные сертификатом с истекшим сроком действия.
|
-
BG_SSL_IGNORE_UNKNOWN_CA
- 0x0008
|
Игнорируйте ошибки, связанные с неизвестным центром сертификации (ЦС).
|
-
BG_SSL_IGNORE_CERT_WRONG_USAGE
- 0x0010
|
Игнорировать ошибки, связанные с использованием сертификата.
|
-
BG_HTTP_REDIRECT_POLICY_ALLOW_SILENT
- 0x0000
|
Позволяет серверу перенаправлять запрос на другой сервер. Это значение по умолчанию.
|
-
BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT
- 0x0100
|
Позволяет серверу перенаправлять запрос на другой сервер. BITS обновляет удаленное имя окончательным URL-адресом.
|
-
BG_HTTP_REDIRECT_POLICY_DISALLOW
- 0x0200
|
Places задание в состоянии неустранимой ошибки, когда сервер перенаправляет запрос на другой сервер. BITS обновляет удаленное имя перенаправленным URL-адресом.
|
-
BG_HTTP_REDIRECT_POLICY_MASK
- 0x0700
|
Битовая маска, которую можно использовать со значением флага безопасности, чтобы определить, какая политика перенаправления действует. Он не включает ALLOW_HTTPS_TO_HTTP флага.
В следующем примере показано, как использовать эту маску для проверки политики перенаправления 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
|
Позволяет серверу перенаправлять HTTPS-запрос на URL-адрес HTTP.
Этот флаг можно объединить с BG_HTTP_REDIRECT_POLICY_ALLOW_SILENT и BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT.
|
Возвращаемое значение
Возвращает S_OK при успешном выполнении.
Требования
| Требование |
Значение |
|
Минимальная версия клиента |
Windows Vista |
|
Минимальная версия сервера |
Windows Server 2008 |
|
Целевая платформа |
Windows |
|
Header |
bits2_5.h (включая Bits.h) |
|
Библиотека |
Bits.lib |
См. также раздел
IBackgroundCopyJobHttpOptions
IBackgroundCopyJobHttpOptions::SetSecurityFlags